Auch verfügbar in: DE Deutsch

Unraid Installation

Zuletzt aktualisiert: 30.09.2026

Inhalt

Once the template has been approved for the Community Apps store, the Community Apps plugin is the easiest way. According to the repo the entry has been submitted but is not approved yet. Until then, use the manual template installation below.

  1. Open the Unraid web UI and go to the Apps tab.
  2. Search for ITSWEBER Play.
  3. Click Install on the ITSWEBER Play card.
  4. The template editor opens. Configure the following fields:
Variable Default Description
PUBLIC_URL https://play.example.com Public HTTPS URL of your instance without trailing slash. Must point to the reverse proxy.
NEXT_PUBLIC_SITE_URL https://play.example.com Same value as PUBLIC_URL.
AUTH_SECRET (empty) Generate with openssl rand -hex 32.
POSTGRES_PASSWORD (empty) Generate with openssl rand -hex 24 and put the same value into DATABASE_URL in place of REPLACE_WITH_POSTGRES_PASSWORD.
MINIO_ROOT_PASSWORD (empty) Generate with openssl rand -hex 24.
S3_SECRET_KEY (empty) Same value as MINIO_ROOT_PASSWORD.
INITIAL_ADMIN_EMAIL admin@example.com Pre-fills the admin field in the first-run wizard.
INITIAL_ADMIN_PASSWORD (empty) Marked as required in the template.
WebUI Port 3000 The container's only port.
  1. Click Apply. Unraid pulls the image and starts the container.

Manual Template Installation

If ITSWEBER Play is not yet available in the Community Apps store, you can install the template manually:

  1. Download itsweber-play.xml from the GitHub repository.
  2. Copy it to /boot/config/plugins/dockerMan/templates-user/ on your Unraid server.
  3. Go to Docker tab → Add Container — the ITSWEBER Play template will now appear in the template dropdown.
  4. Proceed with the configuration as described above.

Data Persistence

All application data (database, video files, thumbnails, configuration) is stored inside the container at /data. Unraid maps this to the appdata share by default:

/mnt/user/appdata/itsweber-play/data

Do not delete this folder — it contains your Postgres database and all MinIO object storage. Back it up regularly using Unraid's built-in backup tools or the script scripts/backup-all-in-one.sh from the repository. scripts/backup.sh is meant for the multi-container stack.

First Run

After the container starts (allow up to about 90 seconds for internal services to initialize):

  1. Navigate to http://[unraid-ip]:3000 in your browser.
  2. The first-run wizard will guide you through admin account creation and basic instance setup.

Updating

The template uses the :main tag. It is rebuilt on every push to the main branch, so it is the current development state, not a tested release.

  1. Go to the Docker tab in Unraid.
  2. Click the container name itsweber-play.
  3. Select Check for Updates.
  4. If an update is available, click Update.

The container restarts with the new image. Prisma migrations run automatically on startup — no manual steps required.

Reverse Proxy

For HTTPS and a clean domain name, place ITSWEBER Play behind a reverse proxy.

Nginx Proxy Manager

Add a new proxy host:

  • Domain name: play.example.com
  • Scheme: http
  • Forward hostname: [unraid-ip]
  • Forward port: 3000
  • Enable Block Common Exploits and Websockets Support
  • Request a Let's Encrypt certificate on the SSL tab

Set PUBLIC_URL and NEXT_PUBLIC_SITE_URL to https://play.example.com in the container template and restart. The proxy's maximum request size must cover MAX_UPLOAD_SIZE_MB (default 8192).

Traefik (Unraid community Traefik plugin)

Add these labels to the container via the Extra Parameters field:

--label traefik.enable=true
--label traefik.http.routers.play.rule=Host(`play.example.com`)
--label traefik.http.routers.play.entrypoints=websecure
--label traefik.http.routers.play.tls.certresolver=letsencrypt
--label traefik.http.services.play.loadbalancer.server.port=3000

Verwandte Seiten