Skip to main content

Docker Compose Example

This page provides a complete Docker Compose configuration for running Hyppot with PostgreSQL. The example includes the necessary services, volumes, and environment variables.

version: '3.8'

services:
  hyppot:
    image: ghcr.io/hyppot/hyppot-server:latest
    container_name: hyppot-server
    ports:
      - "8080:8080"
    volumes:
      - hyppot_logs:/app/storage/logs
    environment:
      - DB_CONNECTION_STRING=Host=postgres;Database=hyppotdb;Username=postgres;Password=postgres;
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:15
    container_name: hyppot-postgres
    environment:
      - POSTGRES_DB=hyppotdb
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  hyppot_logs:
    driver: local
  postgres_data:
    driver: local

How to Use​

  1. Copy the configuration: Copy the docker-compose.yml example above
  2. Save to file: Create a docker-compose.yml file in your project directory
  3. Customize settings: Update environment variables, ports, and passwords as needed
  4. Run the stack: Execute docker-compose up -d
  5. Access Hyppot: Navigate to http://localhost:8080/hyppot/panel

Configuration Tips​

Security Considerations​

Production Considerations​

Important: The examples above show basic configuration options for demonstration purposes. For production deployments, implement proper security measures including strong passwords, secret management (Docker secrets or external secret stores), regular backups, monitoring, and access controls. Never use default passwords in production environments!

  • Load Balancing: To avoid migration conflicts, start instances sequentially
  • Resource limits: Set memory and CPU limits for containers

Next Steps​