Skip to content
MetaTana
UNRAID INSTALL

Install MetaTana on Unraid.

One container, one persistent appdata folder, and your existing media share. Follow the fields below in Unraid’s Add Container screen—no terminal, Compose file, or separate database needed.

Start the setupDetailed reference
About 10 minutesNo terminalUnraid x86_64
Your finished container
MetaTana · Bridge network
Privileged off
Repository
ghcr.io/metatana/metatana-app:stable
Web port
3000 → 3000
App data
/mnt/user/appdata/metatana → /app/data
Media
/mnt/user/Media → /media
Permissions
PUID 99 · PGID 100
Clean restarts
NEXT_MANUAL_SIG_HANDLE 1
Before you begin

Four things to check first.

Docker is enabled

Your Unraid array is started and the Docker tab is visible.

Know your share name

Open Shares and note the exact media path, such as /mnt/user/Media. Capitalization matters.

Internet and email work

MetaTana needs outbound HTTPS to pull the image and complete free email-code sign-in.

Keep it on your LAN

This guide exposes the WebUI to your local network. Do not forward the port directly to the internet.

STEP 01

Add the container

In the Unraid WebGUI, open Docker, select Add Container, and enter these basic settings. Leave fields not shown at their defaults.

Name
MetaTana
Repository
ghcr.io/metatana/metatana-app:stable
Network Type
Bridge
WebUI
http://[IP]:[PORT:3000]/
Privileged
Off
Docker User
Leave blank

Do not add --user under Extra Parameters. The image uses PUID and PGID after preparing appdata.

This is a manual Add Container setup. You do not need a Community Apps template.
STEP 02

Add the port and appdata

Use Add another Path, Port, Variable, Label or Device once for the port and once for the persistent appdata path.

Port · Web UI
Container Port
3000
Host Port
3000

If 3000 is already used, change only this host port—for example, to 3001.

Connection Type
TCP
Path · App Data
Container Path
/app/data
Host Path
/mnt/user/appdata/metatana
Access Mode
Read/Write
STEP 03

Mount your media

Add a Path and replace the example host path with the exact share shown under Unraid → Shares.

Name
Media
Container Path
/media
Host Path
/mnt/user/Media

Example only. Use your real, case-sensitive Unraid share path.

Access Mode
Read Only or Read/Write

Choose Read Only for a scan-and-review trial. Choose Read/Write for NFOs, artwork, rename, organize, or other file changes.

Separate shares are fine: map Movies to /media/movies and TV to /media/tv. Avoid mapping all of /mnt/user when a narrower share will do.

STEP 04

Add runtime variables

Add PUID, PGID, and NEXT_MANUAL_SIG_HANDLE as Variables. MEDIA_DIRS already defaults to /media, so adding it is optional when you use the path shown here.

PUID
99
PGID
100
NEXT_MANUAL_SIG_HANDLE
1
MEDIA_DIRS (optional)
/media

The stable image already uses this default. It does not create or scan a source for you.

If you deliberately use custom share ownership or ACLs, use IDs that already have the required access. Do not fix a permission error with chmod 777. The signal-handling variable lets MetaTana finish releasing its runtime lease before Unraid stops or recreates the container.

STEP 05

Create, open, and scan

Review the values and select Create (or Apply if that is your Unraid version's label). Keep the page open while the image downloads, then select Done.

  1. 1Back on Docker, select the MetaTana icon, then Logs. Startup should settle without repeating permission or database errors.
  2. 2Select WebUI, or open http://YOUR-UNRAID-IP:3000 in a browser. Use your chosen host port if you changed it.
  3. 3Enter your email, then enter the six-digit sign-in code sent to it. A free account works; Pro is not required for local library features.
  4. 4On Home, find First start and select Add folders manually. Choose /media—not /mnt/user/Media—and declare the source as Movie, TV, or Anime.
  5. 5Start with a small scan and review several matches before enabling broad file-writing workflows.
Quick health check
http://YOUR-UNRAID-IP:3000/api/health

A running install returns JSON with a status of ok. Also make sure Sources can browse the expected folders under /media. Replace 3000 with your chosen Host Port if you changed it.

You are finished when
  • The WebUI opens after a container restart
  • The health URL returns status ok
  • Sources can browse your folders under /media
  • Your library remains after another restart
  • Auto Start is On in the Unraid Docker tab

After the restart and persistence checks pass, return to the Unraid Docker tab and switch MetaTana Auto Start to On so it returns after an array or server reboot.

Before every update

Stop MetaTana and back up /mnt/user/appdata/metatana. Keep that path mapped to /app/data when Unraid recreates the container. New images can migrate the SQLite database, so an older image may also require its matching backup.

Need a hand?

The detailed guide covers multiple shares, custom permissions, updates, backups, and the most common Unraid errors.

Open detailed Unraid helpContact supportView container image