Skip to main content

​
System Requirements

​
Minimum Requirements

  • RAM: 8 GB (4 GB available for Docker)
  • Storage: 10 GB free disk space
  • CPU: 2 cores (x86_64 or ARM64)
  • OS:
    • macOS 10.15+ (Catalina or newer)
    • Windows 10/11 with WSL2
    • Linux with kernel 3.10+

​
Software Requirements

To run Dograh AI locally, make sure you have the following installed:
  • Docker (version 20.10 or later)
  • curl - usually preinstalled on macOS/Linux
Docker Compose is included with Docker Desktop. Make sure Docker is running before you begin.

​
Docker Resource Allocation

For Docker Desktop users, ensure Docker has adequate resources:
  1. Open Docker Desktop settings
  2. Navigate to Resources
  3. Allocate at least:
    • Memory: 4 GB (8 GB recommended)
    • CPUs: 2 (4 recommended)
    • Disk: 10 GB

​
Required Ports

Ensure these ports are available:
  • 3010 - Web UI
  • 8000 - API Server
  • 5432 - PostgreSQL
  • 6379 - Redis
  • 9000 - MinIO (S3-compatible storage)
  • 9001 - MinIO Console

​
Checking Port Availability

Check if a port is in use (replace 3010 with the port number): 
lsof -i :3010

​
Docker Registry Options

Dograh images are available from two registries:
  • GitHub Container Registry (Default): ghcr.io/dograh-hq - Recommended for most users
  • Docker Hub: dograhai - Alternative registry
To use a specific registry, set the REGISTRY environment variable: 
# Using GitHub Container Registry (recommended)
REGISTRY=ghcr.io/dograh-hq docker compose up

# Using Docker Hub
REGISTRY=dograhai docker compose up
⌘I