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 include both /app/agent_lab and /app/.runtime host mappings, preserving Spudex workspaces, downloaded models, Redis setup, and native satellite pairing credentials.
  • The container exposes the WebUI/API on port 8501; portal routes mount under that same Tater port.
  • Docker and local command-line runs read the same canonical packaged version as the macOS app, so the bottom-left WebUI label reports the installed build correctly.
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, Spudex workspace files, and downloaded Faster Whisper/Vosk/Kokoro/Pocket TTS/Piper models can be lost on rebuild/update.
  • If /app/.runtime is not mounted, Redis setup, encryption state, and Tater Native satellite pairing credentials 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