Skip to main content

Configuration

What's the difference between ORIGIN and BETTER_AUTH_URL?​

Both should usually be set to the same value:

  • ORIGIN: Trusted origin for CSRF protection (your external URL)
  • BETTER_AUTH_URL: Base URL for authentication callbacks

Example:

environment:
  - ORIGIN=https://cinephage.yourdomain.com
  - BETTER_AUTH_URL=https://cinephage.yourdomain.com

Why can't I access Cinephage externally?​

Common causes:

  1. Firewall - Port 3000 (or your custom port) not open
  2. ORIGIN not set - Must set ORIGIN environment variable
  3. BETTER_AUTH_URL not set - Required for external access
  4. Host binding - Use 0.0.0.0 not 127.0.0.1

How do I configure PUID/PGID?​

Get your IDs:

id -u  # User ID
id -g  # Group ID

Docker Compose:

environment:
  - PUID=1000
  - PGID=1000

This ensures files are created with correct ownership.

Why are my file permissions wrong?​

Check PUID/PGID:

# Check current IDs
id

# Check file ownership
ls -la /path/to/media

Fix permissions:

# Docker
sudo chown -R 1000:1000 ./config

# Or run container as your user
docker run --user $(id -u):$(id -g) ...

Quick Command Reference​

Get user/group IDs:

id

Fix permissions:

sudo chown -R $(id -u):$(id -g) ./config

Check environment variables:

docker compose exec cinephage env | grep -E "(ORIGIN|PUID|PGID)"

See Also​