Pinchflat

YouTube media manager. Downloads and organizes YouTube channels and playlists automatically, saving content to the NAS.

Where it runs

• Host: Nexus (192.168.1.226)
• UI: http://192.168.1.226:8945
• Managed by: Komodo (Stack pinchflat)
• Compose file: pinchflat/docker-compose.yml in homelab-docker repo

Docker

Docker on Nexus is installed via snap. Always use docker compose (with a space).

• Image: ghcr.io/kieraneglin/pinchflat:v2025.6.6
• Config volume: /mnt/server/containers/pinchflat/ → /config
• Downloads volume: /mnt/nas/Youtube/ → /downloads (Hyperion NAS)

Renovate Updates

Pinchflat publishes semver tags (v2025.x.y). Renovate will open PRs automatically when new versions are available. This service has no stateful database — it only stores config and downloaded media files — so updates are generally low risk. Review the release notes, then merge.

After merge, Komodo redeploys via the standard webhook pipeline.

Troubleshooting

# Container logs
ssh matt@192.168.1.226 'docker logs pinchflat --tail 50'

# Manual redeploy
ssh matt@192.168.1.226 'cd /home/matt/repos/homelab-docker/pinchflat && docker compose up -d'

# Check what image tag is actually running
ssh matt@192.168.1.226 'docker ps --format "table {{.Image}}\t{{.Names}}"'

Downloads not appearing on the NAS

1. Confirm /mnt/nas/Youtube/ is mounted on Nexus: ssh matt@192.168.1.226 'ls /mnt/nas/Youtube'
2. If the mount is missing, the NAS share has dropped — check Hyperion (192.168.1.217) is online and the fstab/autofs entry is healthy.
3. Check container logs for yt-dlp errors (rate limiting, unavailable videos, format errors).

Service broken after image update — rollback

# Edit the compose file on Nexus to restore the old tag, then redeploy
ssh matt@192.168.1.226
vi /home/matt/repos/homelab-docker/pinchflat/docker-compose.yml
docker compose -f /home/matt/repos/homelab-docker/pinchflat/docker-compose.yml up -d

Or revert the merge commit in Forgejo — Komodo will redeploy on the next push to main.