Hades, up and running.

Set up with Docker Compose

Run Hades from the published Docker image and keep the config directory mounted so the server identity and database survive restarts.

1. Prepare folders

mkdir -p /docker/Hades/config

2. Create your compose file

Save the compose file below as docker-compose.yml. Change the host path, UID/GID, or timezone if your system uses different values.

services:
  hades:
    image: docker.io/anqui3tas/hades-server:Alpha
    container_name: Hades
    user: "1000:100"
    environment:
      - TZ=America/Los_Angeles
    volumes:
      - /docker/Hades/config:/config
    ports:
      - 8124:8124
    restart: unless-stopped

3. Start Hades

docker compose pull
docker compose up -d

4. Verify the server

curl http://127.0.0.1:8124/health
curl http://127.0.0.1:8124/version
curl http://127.0.0.1:8124/database
curl http://127.0.0.1:8124/setup/status

5. Connect from Icarus

1. Open the latest Icarus TestFlight build.
2. If Icarus is running on the same machine, add http://127.0.0.1:8124.
3. If Icarus is running on another device, use the hostname or address of the machine running Docker, such as http://your-server.local:8124.
4. Complete first-run setup or sign in with your Pantheon account when prompted.

Persistent paths

• /config stores the Hades server identity and SQLite database.
• Add more volume mounts only when you need Hades to access additional host paths.