mirror of
https://github.com/dograh-hq/dograh.git
synced 2026-06-10 08:05:22 +02:00
64 lines
1.7 KiB
Markdown
64 lines
1.7 KiB
Markdown
|
|
# Prerequisites
|
|||
|
|
|
|||
|
|
## 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](https://docs.docker.com/get-docker/) (version 20.10 or later)
|
|||
|
|
- [curl](https://curl.se/download.html) usually preinstalled on macOS/Linux
|
|||
|
|
|
|||
|
|
> **Note**
|
|||
|
|
> 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)
|
|||
|
|
```bash
|
|||
|
|
lsof -i :3010
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Docker Registry Options
|
|||
|
|
|
|||
|
|
Dograh images are available from two registries that you can choose from:
|
|||
|
|
|
|||
|
|
- **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 either of the following:
|
|||
|
|
|
|||
|
|
##### Using GitHub Container Registry (recommended) or Docker Hub
|
|||
|
|
```bash
|
|||
|
|
REGISTRY=ghcr.io/dograh-hq docker compose up
|
|||
|
|
|
|||
|
|
REGISTRY=dograhai docker compose up
|
|||
|
|
```
|