Install the full stack

This page assumes Docker, Docker Compose, and make are installed and you have read the Full-stack setup overview.

1. Clone the skeleton #

git clone https://github.com/Orchesty/orchesty-skeleton my-orchesty
cd my-orchesty
rm -rf .git && git init

The repo gives you a fully wired docker-compose.yml, a Makefile, a worker/ subfolder with its own Makefile and SDK install, a topology/ folder for exported topology definitions, and a .env.dist template. Reinitialising git makes the directory your project rather than a fork.

2. Run make init-dev #

make init-dev is the one-shot bootstrapper. From the project root:

make init-dev

It does everything end to end:

• Renders .env from .env.dist (your UID/GID, a random ORCHESTY_API_KEY, default DEV_IP, default ports).
• docker compose pull and docker compose up -d --force-recreate --remove-orphans for the platform services (Admin UI, backend, MongoDB, RabbitMQ, supporting services, worker).
• Enables the RabbitMQ consistent-hash plugin and restarts the broker.
• Updates MongoDB schemas and indexes.
• Registers the bundled worker container with the platform (service:install worker worker:8080).
• Installs and publishes any topology definitions found in topology/.
• Issues an API token from ORCHESTY_API_KEY for the worker.

The first run is the slowest (image downloads, schema setup). Subsequent runs are fast.

3. Open the Admin UI and onboard #

Open http://127.0.0.1 in your browser. On first start the Admin UI greets you with an onboarding form to create the initial account; subsequent visits show the regular login screen.