cal/claude-home
1
0
Fork 0
Code Issues 6 Pull Requests 4 Actions Packages Projects Releases Wiki Activity
main
claude-home/tdarr/examples/tdarr-server-setup
History
Cal Corum 4b7eca8a46
All checks were successful
Reindex Knowledge Base / reindex (push) Successful in 3s
Details
docs: add YAML frontmatter to all 151 markdown files 
Adds title, description, type, domain, and tags frontmatter to every
doc for improved KB semantic search. The description field is prepended
to every search chunk, and domain/type/tags enable filtered queries.

Type values: context, guide, runbook, reference, troubleshooting
Domain values match directory structure (networking, docker, etc.)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 09:00:44 -05:00
..
docker-compose.yml CLAUDE: Migrate to technology-first documentation architecture 2025-08-12 23:20:15 -05:00
README.md docs: add YAML frontmatter to all 151 markdown files 2026-03-12 09:00:44 -05:00

README.md

title description type domain tags
Tdarr Server Setup Example Reference for Tdarr server directory structure, storage strategy (local vs network), major version upgrade process, and common issues with disk space, permissions, and network filesystems. reference tdarr
tdarr
docker
server
sqlite
storage
upgrade

Tdarr Server Setup Example

Directory Structure

~/container-data/tdarr/
├── docker-compose.yml
├── stonefish-tdarr-plugins/     # Custom plugins
├── tdarr/
│   ├── server/                  # Local storage
│   ├── configs/
│   └── logs/
└── temp/                        # Local temp if needed

Storage Strategy

Local Storage (Fast Access)

  • Database: SQLite requires local filesystem for WAL mode
  • Configs: Frequently accessed during startup
  • Logs: Regular writes during operation

Network Storage (Capacity)

  • Backups: Infrequent access, large files
  • Media: Read-only during transcoding
  • Cache: Temporary transcoding files

Upgrade Process

Major Version Upgrades

  1. Backup current state

    docker-compose down
cp docker-compose.yml docker-compose.yml.backup

  2. For clean start (recommended for major versions):

    # Remove old database
sudo rm -rf ./tdarr/server
mkdir -p ./tdarr/server

# Pull latest image
docker-compose pull

# Start fresh
docker-compose up -d

  3. Monitor initialization

    docker-compose logs -f

Common Issues

Disk Space

  • Monitor local database growth
  • Regular cleanup of old backups
  • Use network storage for large static data

Permissions

  • Container runs as PUID/PGID (usually 0/0)
  • Ensure proper ownership of mounted directories
  • Use sudo rm -rf for root-owned container files

Network Filesystem Issues

  • SQLite incompatible with NFS/SMB for database
  • Keep database local, only backups on network
  • Monitor transcoding cache disk usage