Docker Deployment

This guide covers basic local deployment using Docker. This method is not recommended for production - use it only for testing and evaluation. For production deployments, consider:

• Kubernetes
• AWS ECS
• Azure App Services

Prerequisites

• Docker installed
• Docker Compose (optional)

Running the Container

1. Create Persistent Volume

docker volume create altcha_sentinel_data

2. Start the Container

docker run -d -p 8080:8080 -v altcha_sentinel_data:/data ghcr.io/altcha-org/sentinel:latest

3. Access the Application

Default credentials:

• Username: root
• Password: root

Access endpoints:

• Web Interface: http://localhost:8080
• API: http://localhost:8080/v1
• API Documentation: http://localhost:8080/v1/docs

Environment Configuration

The server automatically generates a default .env file (stored in /data) containing cryptographically secure random secrets.

While no custom configuration is required, you can:

1. Modify the generated .env file
2. Pass environment variables directly to the container
3. Mount a custom .env file

For complete environment variable documentation, see:
ENV Variables Reference

Docker Compose Configuration

Recommended docker-compose.yml:

version: '3'

services:
  altcha_sentinel:
    image: ghcr.io/altcha-org/sentinel:latest
    restart: unless-stopped
    env_file: .env  # Optional
    ports:
      - "8080:8080"
    volumes:
      - altcha_sentinel_data:/data

volumes:
  altcha_sentinel_data:

Next Steps

• Follow the Integration Checklist to ensure a secure deployment.