Start IAS

Start IAS

IAS stands for Idelium Administration Server. In the Docker stack it is provided by Idelium Web, Idelium API, MariaDB, and an initialization container that runs database setup before the API becomes available.

Demo mode

Use demo mode for a local evaluation:

cd idelium-docker
cp .env.example .env
./start-idelium.sh --demo

Demo mode performs the following actions:

1. Creates missing random development secrets under the ignored secrets/ directory.
2. Builds MariaDB, API, and frontend images from the local checkouts.
3. Starts MariaDB and waits for its health check.
4. Runs migrations and demo seed data through ideliuminit.
5. Starts the API and frontend only after dependencies are ready.
6. Runs an HTTPS smoke test through the frontend reverse proxy.

Open the interface at:

https://localhost

If HTTPS_PORT is set in .env, open that port instead.

Demo identities

Demo credentials are generated locally and are not printed to the terminal. Read them from the ignored secret files only when you need to sign in:

secrets/demo_email
secrets/demo_password
secrets/admin_email
secrets/admin_password

Keep those values private. Do not add them to screenshots, issue comments, logs, or documentation.

Production-oriented local mode

Use production mode when testing the stack with real secret files and a trusted certificate:

./start-idelium.sh --production

Production mode builds local images, requires mounted secret files, requires a trusted certificate, and does not enable demo seed data.

Release mode

Use release mode when the deployment must pull immutable published images rather than build from adjacent source checkouts:

./start-idelium.sh --release

Release mode should be used only with reviewed image references and matching configuration.

Stop the stack

Stop demo containers while keeping database and certificate volumes:

docker compose -f docker-compose.yml -f compose.demo.yml down

Remove demo volumes when you intentionally want a clean database and certificate:

docker compose -f docker-compose.yml -f compose.demo.yml down --volumes

Removing volumes is destructive. Secret files under secrets/ remain on disk until you rotate or remove them intentionally.

Troubleshooting startup

If startup fails, inspect the initialization service first:

docker compose ps
docker compose logs --tail=100 ideliuminit
docker compose logs --tail=100 ideliumapi
docker compose logs --tail=100 ideliumfe

The API is intentionally blocked until initialization completes successfully.