Docker Compose on a Linux server¶
Docker Compose runs the packaged AppControl topology on one Linux host: PostgreSQL 16, backend, frontend, gateway, certificate initialization and HTTPS reverse proxy.
Use this mode for a pilot or a small single-host service when your organization already operates Docker Engine on Linux. For Windows Server, use the standalone installer or create a Linux VM for Compose.
Prerequisites¶
- a supported Linux distribution
- Docker Engine and Docker Compose v2
- outbound access to
github.comandghcr.io gh,tarandopenssl
Install¶
Download the self-contained deployment bundle from the customer release:
mkdir appcontrol && cd appcontrol
gh release download \
--repo xcomponent/appcontrol-release \
--pattern appcontrol-compose.tar.gz
tar xzf appcontrol-compose.tar.gz
cd docker
Create the required secrets:
cp .env.example .env
sed -i "s|CHANGE_POSTGRES_PASSWORD|$(openssl rand -hex 24)|" .env
sed -i "s|CHANGE_JWT_SECRET|$(openssl rand -hex 32)|" .env
sed -i "s|CHANGE_ADMIN_PASSWORD|$(openssl rand -base64 24 | tr -d '/+=' | head -c 24)|" .env
chmod 600 .env
Record the generated SEED_ADMIN_PASSWORD from .env, then start:
docker compose -f docker-compose.release.yaml pull
docker compose -f docker-compose.release.yaml up -d
docker compose -f docker-compose.release.yaml ps
Open https://localhost on the server and sign in with
SEED_ADMIN_EMAIL and SEED_ADMIN_PASSWORD. The first certificate is
self-signed; replace it with the company certificate before production use.
Pin a release¶
Set APPCONTROL_VERSION in .env to a published version instead of latest,
then run:
docker compose -f docker-compose.release.yaml pull
docker compose -f docker-compose.release.yaml up -d
Operate¶
# Status
docker compose -f docker-compose.release.yaml ps
# Logs
docker compose -f docker-compose.release.yaml logs -f --tail=200
# Stop without deleting data
docker compose -f docker-compose.release.yaml down
# Upgrade after changing APPCONTROL_VERSION
docker compose -f docker-compose.release.yaml pull
docker compose -f docker-compose.release.yaml up -d
The pgdata volume contains the database. Never use down -v unless you
intend to erase the installation. See Backup and restore
before using this mode for business data.
Production boundary¶
Compose is a single-host deployment. It does not provide control-plane high availability. For a critical or regulated service, prefer Kubernetes/Helm or OpenShift with managed PostgreSQL, and apply the hardening checklist.