Install in one command.

Drevalis Creator Studio ships as a Docker Compose stack. The installer writes a ready-to-run configuration, pulls the official images, and starts the services.

Quick install

🐧 Linux & macOS

Docker Engine + Compose plugin, or Docker Desktop on macOS.

curl -fsSL https://drevalis.com/install.sh | bash

Read install.sh before piping to bash if you prefer.

🪟 Windows 10 / 11

Requires Docker Desktop (enables WSL2 automatically). Once installed and running, open PowerShell and paste: 

iwr -useb https://drevalis.com/install.ps1 | iex

PowerShell's ExecutionPolicy must allow remote scripts. If it complains, run Set-ExecutionPolicy -Scope Process RemoteSigned first. Read install.ps1 before running if you prefer.

Never used Docker Desktop before?
  1. Download Docker Desktop from docker.com — pick "Windows" → AMD64 or ARM64
  2. Run the installer; accept the WSL2 option when prompted
  3. Reboot when it asks
  4. Launch Docker Desktop from the Start menu and wait until the tray icon (bottom right) is solid, not animated
  5. Open PowerShell and paste the command above

What the installer does

  1. Creates /srv/drevalis
  2. Writes docker-compose.yml pulling official images from ghcr.io/drevalis/*
  3. Generates a Fernet encryption key and writes .env
  4. Pulls all images (~3 GB, coffee break)
  5. Runs database migrations
  6. Starts the stack
  7. Prints the URL to open

System requirements

Minimum

  • Linux, macOS (Docker Desktop), or Windows (WSL2 + Docker Desktop)
  • 8 CPU cores, 16 GB RAM
  • 50 GB free disk
  • Docker Engine 24+, Docker Compose v2

Recommended

  • NVIDIA GPU with 12 GB+ VRAM (for scene generation)
  • 32 GB RAM
  • 200 GB SSD
  • Fast internet for first-time model downloads

External services you need

Drevalis Creator Studio orchestrates these three tools. Install them separately so you control the models:

ComfyUI

Scene image / video generation.

Install guide →

LM Studio or Ollama

Local LLM for scripts. Or plug in Claude / OpenAI-compatible.

LM Studio →

FFmpeg

Installed inside the Docker container — nothing to do.

Included

After install

  1. Open http://localhost:3000
  2. Paste your license key (from the purchase email) into the activation screen
  3. Settings → ComfyUI Servers → add your ComfyUI URL (e.g. http://host.docker.internal:8188)
  4. Settings → LLM Configs → add your LM Studio / Ollama endpoint
  5. Settings → Voice Profiles → pick a default TTS voice
  6. Create your first series and generate an episode

Updates

In-app, one click. Settings → Updates → Update now. The updater sidecar pulls the new images and restarts the stack automatically. No terminal needed.

Prefer manual?

cd /srv/drevalis
docker compose pull
docker compose up -d --remove-orphans

Manual install (if you'd rather not pipe to bash)

Create a docker-compose.yml with:

services:
  app:
    image: ghcr.io/drevalis/creator-studio-app:latest
    restart: unless-stopped
    ports: ["8000:8000"]
    env_file: .env
    volumes: [./storage:/app/storage, updater_shared:/shared]
    depends_on: [postgres, redis]

  worker:
    image: ghcr.io/drevalis/creator-studio-app:latest
    restart: unless-stopped
    env_file: .env
    volumes: [./storage:/app/storage]
    command: python -m arq shortsfactory.workers.settings.WorkerSettings
    depends_on: [postgres, redis]

  frontend:
    image: ghcr.io/drevalis/creator-studio-frontend:latest
    restart: unless-stopped
    ports: ["3000:3000"]
    depends_on: [app]

  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: drevalis
      POSTGRES_PASSWORD: drevalis
      POSTGRES_DB: drevalis
    volumes: [pg:/var/lib/postgresql/data]

  redis:
    image: redis:7-alpine
    restart: unless-stopped

  updater:
    image: ghcr.io/drevalis/creator-studio-updater:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - .:/project
      - updater_shared:/shared

volumes:
  pg:
  updater_shared:

Then set .env with ENCRYPTION_KEY and LICENSE_SERVER_URL=https://license.drevalis.com, and run docker compose up -d.

Still stuck?

Email support@drevalis.com with the output of docker compose logs app worker and we'll help.