Documentation

Everyday guides for both products live right here. The deeper Server documentation — installation, configuration, architecture — lives with the source on GitHub, versioned with the code you're actually running.

Pictaria Server

The Server guide explains every tab of the dashboard for day-to-day use — Insights, Enrich, Curate, Albums, and the rest — no terminal required. Jump straight to a section:

Insights Timeline, people, places, records — every number clickable
Enrich & Curate AI descriptions, then picking the keepers
Albums Rule-based Immich albums that maintain themselves
Frame stats & Remote What the frames have shown; control them from your phone
Activity Filter and export a privacy-bounded support history
Settings Devices, locations, voice, backups — all from the browser

Running it yourself? The technical docs, versioned with the source:

README What it is, quickstart, and the tour
Getting started From zero to a running container
Running as a service systemd, launchd, VPN boot order, and uptime monitoring
Immich compatibility Supported and tested versions, runtime checks, and upgrade checklist
Configuration reference Every environment variable and setting
Enrich & Curate AI providers, taxonomy, review workflow
Smart Albums Rules, Best of ranking, synchronization, exclusions, and lifecycle
Recommended AI models Dated local and cloud starting points for each Pictaria role
Insights How the sweep works and what it computes
Activity history What is recorded, deliberately excluded, retained, and exportable
Backups Protecting your Pictaria data
Upgrading Release-tagged Docker and Node upgrades, verification, and safe rollback
Release notes Changes, compatibility notes, and known limitations by release
Security policy Supported versions, deployment boundaries, and private reporting
Wake words Custom wake phrases: create one at openwakeword.com, install, troubleshoot
Product vision The philosophy behind understanding, curating, and enjoying your collection
Architecture For the curious and the contributing
Contributing Development workflow, pull requests, testing, and DCO sign-off

Pictaria Frame

The Frame guide covers first-run setup and every setting, in the order the app presents them. Jump straight to a section:

First-run setup Connect Immich → choose photos → optional server → quick tips, crash reports & terms
Upgrades & Settings PIN What the one-time upgrades add; guest-proofing the frame
Albums, Timeline & content source Which photos show, and how often the frame re-reads them
Slideshow & display Interval, clock, overlays, brightness, night dimming, backgrounds
Voice, weather & the Server connection Wake phrase, spoken vs on-screen answers, weather location
Troubleshooting Connection errors, missing new photos, dark screens, voice

Quickstart

The Server, in one block.

services:
  pictaria:
    image: ghcr.io/pictaria-ai/pictaria-server:1.1.0 # explicit release
    container_name: pictaria
    restart: unless-stopped
    ports:
      - "4080:4080"
    environment:
      IMMICH_BASE_URL: ${IMMICH_BASE_URL}   # your Immich URL
      IMMICH_API_KEY: ${IMMICH_API_KEY}     # an Immich API key
      APP_PASSWORD: ${APP_PASSWORD}         # protects the web UI
    volumes:
      - pictaria-data:/data

volumes:
  pictaria-data:

Everything else — AI providers, voice, weather, backups — is configured from the web UI at http://your-server:4080.