Quick Start Guide

1. Create a directory for TheiaCast

mkdir theiacast
cd theiacast

2. Create a docker-compose.yml file

services:
  postgres:
    image: postgres:15-alpine
    container_name: theiacast-postgres
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: your-secure-password
      POSTGRES_DB: theiacast
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    restart: unless-stopped

  backend:
    image: ghcr.io/jimmyeao/theiacast-backend:latest
    container_name: theiacast-backend
    environment:
      - ConnectionStrings__Default=Host=postgres;Port=5432;Database=theiacast;Username=postgres;Password=your-secure-password
      - ASPNETCORE_ENVIRONMENT=Production
      - Jwt__Secret=your-secret-key-here-minimum-32-characters
      - BASE_URL=http://backend:8080
    ports:
      - "5001:8080"
    depends_on:
      - postgres
    volumes:
      - theiacast_media:/app/wwwroot
    restart: unless-stopped

  frontend:
    image: ghcr.io/jimmyeao/theiacast-frontend:latest
    container_name: theiacast-frontend
    ports:
      - "80:80"
    depends_on:
      - backend
    restart: unless-stopped

volumes:
  postgres_data:
  theiacast_media:

3. Start the services

docker compose up -d

4. Wait for services to start (about 30 seconds)

docker compose logs -f backend

Wait until you see "Application started" or similar message, then press Ctrl+C.

1. Open your web browser

Navigate to:

(Or use your server's IP address if accessing remotely)

2. Create an admin account

• The first user to register becomes the administrator
• Click "Register"
• Fill in username and password
• Click "Create Account"

3. You're in!

You should now see the TheiaCast dashboard.

1. In the TheiaCast dashboard

• Click "Devices" in the sidebar
• Click "+ Add Device"
• Enter a name (e.g., "Lobby Display")
• Enter a unique Device ID (e.g., "lobby-01")
• Click "Create"
• Copy the device token shown in the popup

2. Download and install the Windows client

Download from our CDN

Run the installer - it will prompt you for the server URL, device ID, and device token from step 1.

3. Verify connection

• Go back to the dashboard
• The device should show as "Online" with a green indicator

1. Add content

• Click "Content" in the sidebar
• Click "+ Add Content"
• Enter a name (e.g., "Welcome Page")
• Enter a URL (e.g., "https://example.com")
• Click "Save"

2. Create a playlist

• Click "Playlists" in the sidebar
• Click "+ Create Playlist"
• Enter a name (e.g., "Main Lobby")
• Click "Create"
• Click "Add Item" to add your content
• Set display duration (in seconds, or 0 for permanent)
• Click "Save"

3. Assign to device

• Click "Devices" in the sidebar
• Find your device and click to flip the card
• Click "Assign Playlist"
• Select your playlist
• Click "Assign"

4. Watch the magic!

Your display should now show the content.