Docker¶
Prerequisites¶
- Docker Desktop or Docker Engine
- UNI source code (see setup)
Running¶
From the UNI source directory:
docker compose up
This builds the container image and starts UNI. The server will be available at https://localhost:6001. Press Ctrl+C to stop.
GPU support¶
For Nvidia GPUs:
docker compose -f docker-compose.yml -f docker-compose.cuda.yml up
For AMD GPUs:
docker compose -f docker-compose.yml -f docker-compose.rocm.yml up
Configuration¶
Set environment variables in a .env file or pass them directly:
| Variable | Default | Description |
|---|---|---|
UNI_PORT |
6001 |
Server port |
UNI_HOSTNAME |
auto-detected | Server hostname for TLS cert |
UNI_LOG_LEVEL |
INFO |
Log level (DEBUG, INFO) |
PUID |
1000 |
User ID inside the container |
PGID |
1000 |
Group ID inside the container |
TZ |
UTC |
Timezone |
Volumes¶
| Mount | Container path | Purpose |
|---|---|---|
./user |
/app/user |
User data and settings |
./models |
/app/models |
Downloaded models |
./plugins (read-only) |
/plugins |
Plugin source code |
Customization¶
Create a docker-compose.override.yml file for local customizations. This is automatically picked up by Docker Compose and won't conflict with updates.