Skip to content

Direx on a server

install.sh sets up Direx with Docker Compose. See “Run it on a server” in the main README for the steps.

File What it is
install.sh The installer. Safe to run again
compose.yml Postgres and Direx; Caddy under the public profile
Caddyfile HTTPS for the domain given to --public
.env.template Copied to .env by the installer, which fills in the values. Never commit .env
ci.compose.yml CI only: a test mail server for .github/workflows/install.yml

After the install, run Compose from this folder:

docker compose ps
docker compose logs -f direx
docker compose exec direx bun run doctor

Keys and other secrets go into the vault, typed by a person, with the value on stdin:

docker compose exec -T direx bun apps/api/src/secrets.ts set provider.anthropic

A stop lets Direx finish what is already sending, for up to six minutes.

From deploy/compose/README.md at v0.1.0. To fix this page, change that file in trydirex/direx; the site picks it up with the next release.