Production deployment
This compose project runs Caddy, the Search API, and a private OpenSearch node.
Caddy serves akyldash.kg over HTTPS and proxies to the API. Only Caddy publishes
ports 80 and 443; the API has no host port, and OpenSearch is reachable only
from the backend's private network.
The current compose intentionally disables the OpenSearch security plugin to match the existing API client. Keep OpenSearch on its private network. The application provides cookie-based accounts for its search API and review workspace; it does not replace host-level network controls or TLS.
First deployment
-
Copy this directory to the host with the repository source.
-
Copy
.env.exampleto.env, set an absoluteDATA_ROOT, and create the secret file referenced byREVIEW_SECRET_FILEoutside the repository:sudo install -d -o root -g root -m 0700 /etc/akyldash sudo sh -c 'umask 077; openssl rand -hex 32 > /etc/akyldash/review_secret'Do not commit
.envor the secret file. -
Put the normalized dataset under
$DATA_ROOT/minjust-normalized/. -
Confirm DNS points through Cloudflare to this origin. Have the owner review the existing firewall rules and allow TCP
80and443before Caddy starts. Caddy requests and renews the origin certificate automatically; use Cloudflare Full (strict) only after HTTPS succeeds. -
Complete and verify the backup/restore setup before starting production. The repository does not yet contain a tested backup script; do not continue until the owner has approved and tested one.
-
Check the rendered configuration:
docker compose --env-file .env -f compose.yaml config -
Start the services:
docker compose --env-file .env -f compose.yaml up -d --build docker compose --env-file .env -f compose.yaml ps curl -fsS https://akyldash.kg/review >/dev/null -
Load the versioned index and switch its alias only after the import and validation succeed, after creating another verified pre-change backup.
Initial administrator and accounts
After starting the backend for the first time, create the initial admin
account with an interactive password prompt:
docker compose --env-file .env -f compose.yaml exec backend python -m search.api --create-admin
The account database is stored at DATA_ROOT/search-users.sqlite3. Back it up
alongside the review database. Sign in at /review; admin can create accounts
with temporary passwords. Each new account must replace its temporary password
at first sign-in. Only the admin login can create, reset, or delete accounts.
If the admin password is lost, reset it in an interactive terminal with:
docker compose --env-file .env -f compose.yaml exec backend python -m search.api --reset-admin-password
The next sign-in requires another password change. Serve the backend behind
HTTPS, rate-limit login requests at the reverse proxy, and keep
COOKIE_SECURE=true in production.
This is a deployment baseline, not a public internet exposure recipe. TLS, backups, monitoring, and a production OpenSearch security configuration must be provided by the host reverse proxy/operations setup.