Documents Stack

← Home

Services running on PCT 104 (documents, 192.168.2.105). Docker storage on ZFS (/tank/docker).

Service URLs

Immich (compose 10)

Photo management at photos.carr-family.org. Services: immich-server, machine-learning, postgres/pgvecto.rs (port 5435), valkey.

GPU: uses -cuda image (ghcr.io/immich-app/immich-machine-learning:release-cuda) with DEVICE=cuda + NVIDIA_VISIBLE_DEVICES=all.

Redeploy (env vars not in .env — export in shell):

pct exec 108 -- bash -c 'export DB_PASSWORD=T5dBbAvgHWceH7jhsxjism4b2Cre9NA DB_USERNAME=immich DB_DATABASE_NAME=immich && docker stack deploy -c /mnt/tank/appdata/portainer/compose/10/docker-compose.yml documents-immich'

Nextcloud (compose 7)

File cloud at cloud.carr-family.org. Services: app (port 8085), cron, postgres:16 (port 5432).

• Nextcloud data migrated to ZFS 2026-05-25 — stored at /mnt/tank/appdata/nextcloud/ inside PCT 104
• PUID/PGID: 33:33

Paperless-ngx (compose 4)

Document management at paperless.carr-family.org. Services: webserver (port 8000), paperless-gpt (port 8080), redis, postgres (port 5433).

Redeploy (env vars not in .env):

pct exec 108 -- bash -c 'export POSTGRES_DB=paperless POSTGRES_USER=paperless POSTGRES_PASSWORD=eWJarhDasRNBu0LfBwuI6VPOXwnRCUy PAPERLESS_SECRET_KEY=J60Om5l2dsL1pUSWz3AQhqizRFhlii8dRzsynYrAfzbBsV316S PAPERLESS_TIME_ZONE=America/Chicago PAPERLESS_URL=https://paperless.carr-family.org "PAPERLESS_CSRF_TRUSTED_ORIGINS=https://paperless.carr-family.org" && docker stack deploy -c /mnt/tank/appdata/portainer/compose/4/docker-compose.yml documents-paperless'

Postgres password gotcha — POSTGRES_PASSWORD only applies on first-init. If the DB is recreated with existing data, a password mismatch causes password authentication failed crash-loop. Fix via local socket (trust auth):

DB=$(pct exec 104 -- docker ps --format '{{.Names}}' | grep 'paperless_db\.' | head -1)
pct exec 104 -- docker exec $DB psql -U paperless -d paperless -c "ALTER USER paperless PASSWORD 'newpassword'"
pct exec 108 -- docker service update --force documents-paperless_webserver

paperless-gpt

LLM-powered title/tag suggestions + OCR at paperless-gpt.carr-family.org (port 8080).

• General LLM: gpt-4o-mini via LiteLLM (http://192.168.2.83:4000)
• OCR LLM: llava:7b via LiteLLM → Ollama on 192.168.2.11
• Tag a document paperless-gpt-ocr to trigger OCR processing
• API token: 71c8ba36985118d419cf9a1f5f8497290d816e10

Linkwarden (compose 2)

Bookmark manager at links.carr-family.org. Services: linkwarden (port 3000), meilisearch, postgres (port 5434).

API token:

eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIn0..jE4UUgAXi4UpbmBi.1HbSWJSBdDAHur9EAI28WT2Cbt4rJqzakS_RrjQq9jT34iRJBb7nEW97Ml218sECdaShktMrdxAXrl6zQFXBkM4G2jpWtSEOUlIKlOH0v1KAtXRfpb9b.tNDkqQ1JdOz6gALxNDKhVA

PUT /api/v1/links/:id gotcha — payload must include collection: {id, name, ownerId} and tags as [{id, name}]. Omitting either returns 400.

Auto-sort script: runs on PCT 109 every 2 minutes — /opt/linkwarden-sort/sort.py. Moves links out of Unorganized (id 1) based on AI tags, URL patterns, title keywords. Log: /var/log/linkwarden-sort.log.

Collection IDs:

OtterWiki (standalone — not Swarm)

This wiki. Docker Compose on PCT 104 at /mnt/tank/appdata/otterwiki/docker-compose.yml.

• Image: redimp/otterwiki:2
• Port: 8081 (host-mode)
• Static route: routes.yml → http://192.168.2.105:8081
• Appdata: /mnt/tank/appdata/otterwiki/ — contains settings.cfg and repository/ (git repo, all pages as .md files)
• PUID/PGID: 33:33

Restart: pct exec 104 -- docker compose -f /mnt/tank/appdata/otterwiki/docker-compose.yml restart