Tater Assistant Docs
Container path

Docker Image

Run the published container image with persistent Agent Lab/.runtime volumes, then configure Redis + Hydra in WebUI.

Medium
Why choose this

Key points

  • The README publishes the image at ghcr.io/tatertotterson/tater:latest.
  • Container persistence warnings now include both /app/agent_lab and /app/.runtime host mappings, which also preserve downloaded voice models.
  • The container exposes the WebUI/API on port 8501; portal routes mount under that same Tater port.
Install flow

Steps

  1. Pull the published image.
  2. Start the container with the main Tater port and persistent volume mappings.
  3. Mount /app/agent_lab and /app/.runtime to host storage so runtime and Redis config persist across rebuilds.
  4. Open the WebUI and complete Redis setup popup if prompted.
  5. Configure Hydra base model settings and optional Beast Mode role routing in Settings.
  6. Open the WebUI at http://localhost:8501 after the container is running.
Important notes
  • If /app/agent_lab is not mounted, runtime data and downloaded Faster Whisper/Vosk/Kokoro/Pocket TTS/Piper models can be lost on rebuild/update.
  • If /app/.runtime is not mounted, Redis setup popup config and Redis encryption key/state can be lost on rebuild/update.
  • The README also calls out Unraid-specific time-zone mappings for /etc/localtime and /etc/timezone.
Commands and config

README snippets for this install path.

Pull the image 
docker pull ghcr.io/tatertotterson/tater:latest
Docker run with persistent runtime paths 
docker run -d --name tater_webui \
  -p 8501:8501 \
  -e TZ=America/Chicago \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  -v /tater_agent_lab:/app/agent_lab \
  -v /tater_runtime:/app/.runtime \
  ghcr.io/tatertotterson/tater:latest
Docker run (same port/volumes, alternate host paths) 
docker run -d --name tater_webui \
  -p 8501:8501 \
  -e TZ=America/Chicago \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  -v /tater_agent_lab:/app/agent_lab \
  -v /tater_runtime:/app/.runtime \
  ghcr.io/tatertotterson/tater:latest
Back to install guide Home Portals Cores