Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ekso.dev/llms.txt

Use this file to discover all available pages before exploring further.

Ekso self-hosts on your infrastructure. Pick the bundle that matches your environment, fetch a free license, and bring up the stack with a single docker compose up -d.

​
Two install paths

PathWhen to pick itBundle
QuickstartNew install, no existing database. Fastest path to a running Ekso.ekso-docker-stack.zip — app + worker + postgres with pgvector preinstalled
Bring your own databaseYou already run Postgres or SQL Server and want Ekso to share it.ekso-docker-byod.zip — app + worker only
Both bundles ship the same Ekso image — same code, same features, same flat-rate license. The only difference is whether the bundle includes a database or expects you to provide one. Native binaries for Windows, macOS, and Linux are on the roadmap.

​
Before you install

  1. Get a license. Drop your email at ekso.app/get-started. The site emails you an activation key (a JWT) and a personalized download link. Free tier is unlimited users, no credit card. Standard and Advanced are flat-rate annual.
  2. Pick an install URL. The public hostname your users will reach Ekso at — for example https://ekso.acme.com. Used as the OAuth audience and for outbound email links. Doesn’t need to resolve before install — you finalize it during the first-run wizard.
  3. Have Docker running. Docker Engine 20+ on Linux, Docker Desktop on macOS or Windows. Quickstart needs ~2 GB free for images on first pull.

​
What’s in the bundle

Each download zip contains:
FilePurpose
docker-compose.ymlService definitions for app, worker, and (Quickstart only) postgres
ekso.jsonInstall configuration. JWT signing key is pre-baked per download. See the configuration reference.
README.mdBundle-local quick reference
The Auth.Jwt.Key in ekso.json is unique to your download. Re-fetching the bundle from ekso.app issues a fresh key, which would invalidate every active session on an existing install. Treat the zip as a one-time install artifact — store it safely if you want a stable reference.

​
After install

Once docker compose up -d settles, navigate to your install URL (or http://localhost:6050 for local dev). Ekso redirects you into the first-run wizard to bootstrap the first tenant, the admin user, and the auth provider. For automated install — useful when an AI agent stands up Ekso on behalf of an operator — see agent onboarding.