Asha

Stream containerized desktops, browsers & apps to any browser. Self-hosted · multi-tenant · a modern container-streaming / VDI / DaaS platform.

A Naiemi Group product · anthracite #1a1a2e · gold #d4af37

End-user desktop — one-click launch, dock, favorites	Admin dashboard — live sessions, agent fleet, utilization
Workspace catalog — containerized desktops, browsers & apps	Tariffs — per-minute / hourly / monthly usage metering

• ✨ Features
• 🏗 Architecture
• 🚀 Quick start
• 🧰 Scripts
• 🗺 Roadmap
• 💛 Support this project
• 📜 License & ownership

Built from scratch or on open-source tooling — nothing derived from any proprietary product.

                           ┌──────────────────────────────────────────────┐
   Browser  ──https──►     │  Traefik (edge + per-session dynamic routing) │
                           └──┬─────────┬─────────────┬──────────────┬─────┘
                              │         │             │              │
                   ┌──────────▼──┐ ┌────▼──────┐ ┌────▼───────┐ ┌────▼──────────────┐
                   │ web (Next)  │ │ api (Nest)│ │ connection │ │ session container │
                   │admin+portal │ │Manager/API│ │   proxy    │ │ KasmVNC | Neko    │
                   └─────────────┘ └──┬───┬────┘ │RDP/VNC/SSH  │ │ + sidecars:       │
                                      │   │      └──┬──────────┘ │ Squid/WireGuard   │
                              ┌───────▼┐ ┌▼──────┐  │ guacd/ssh2 └──────▲────────────┘
                              │postgres│ │ redis │◄─┘                   │ docker / k8s
                              └────────┘ └───┬───┘            ┌─────────┴───────────┐
                                             └────────────────│ agent (dockerode /  │
                                              provision/destroy│   @kubernetes)      │
                                                               └─────────────────────┘

TypeScript end-to-end · pnpm + Turborepo monorepo.

Take a bare Ubuntu/Debian box to a live, signed-in-ready Asha in one line. The installer greets you with the Asha mark, then handles Docker, strong secrets, your domain + TLS, the full stack, and the database migrate + seed:

curl -fsSL https://raw.githubusercontent.com/Kalin0x0/Asha/main/scripts/install.sh | sudo bash

==============================================================================

                            ######  ######
                        ####      ##      ####
                      ###    ##########    ###
                     ##    ####      ####    ##
                    ##    ##    ####    ##    ##
                    ##    ##   ##  ##   ##    ##
                    ##    ##    ####    ##    ##
                     ##    ####      ####    ##
                      ###    ##########    ###
                        ####      ##      ####
                            ######  ######

         _    ____  _   _    _
        / \  / ___|| | | |  / \
       / _ \ \___ \| |_| | / _ \
      / ___ \ ___) |  _  |/ ___ \
     /_/   \_\____/|_| |_/_/   \_\

              C O N T A I N E R   S T R E A M I N G

==============================================================================

  Naiemi Group  ·  VDI / DaaS Platform                       Installer  v1.0.0

sudo bash scripts/install.sh                                   # interactive menu
sudo bash scripts/install.sh --domain asha.example.com \
     --email ops@example.com --yes                             # unattended

Full guide → docs/INSTALL.md.

The web app runs fully on deterministic mock data (NEXT_PUBLIC_API_MODE=mock).

pnpm install
cp .env.example .env
pnpm --filter @asha/web dev
# open http://localhost:3000  → login with any credentials (mock mode)

cp .env.example .env
docker compose up -d --build
# web:      https://asha.local        (add `127.0.0.1 asha.local` to your hosts file)
# api docs: https://asha.local/api/docs

The db-migrate one-shot container syncs the schema with prisma db push and runs the idempotent seed automatically. Default admin credentials are printed by the seed (see packages/db/prisma/seed.ts).

pnpm install
docker compose up -d postgres redis traefik   # infra only
pnpm db:migrate && pnpm db:seed
pnpm dev                                        # turbo runs web + api + agent
# set NEXT_PUBLIC_API_MODE=live in .env to call the real API

All seven phases are complete — 276 unit tests, full typecheck · lint · test · build green across 26 workspace tasks. The per-item build log lives in TODO.md.

Asha is built in the open by Naiemi Group. If Asha saves you time, powers your workspaces, or you'd simply like to see it grow, your support keeps the containers streaming ✨. Every sponsorship goes straight into development, demo hosting, and the next batch of features. Thank you 🙏

The best way to support Asha is GitHub Sponsors — one-off or monthly, cancel anytime:

More platforms activate automatically from .github/FUNDING.yml — see the Sponsoring guide.

⭐ Not able to donate? Starring the repo and sharing Asha helps just as much — it's free and it genuinely moves the needle. New here? The installation guide gets you a live Asha in one command.

Asha is a Naiemi Group product, released under the MIT License. All first-party source in this repository is owned by Naiemi Group. Third-party open-source runtime images and tools (KasmVNC, Neko, Squid, WireGuard, guacd, Fluent Bit, Traefik, Postgres, Redis) are used unmodified under their respective licenses and are never linked into Asha's source.