Troubleshooting
Fix common self-hosting issues. Docker errors, networking problems, app-specific bugs, and configuration pitfalls.
Calibre-Web: Books Not Loading — Fix
Fix Calibre-Web not loading books, showing empty library, or failing to start. Covers database path, permissions, and metadata.db issues. Step-by-step fix.
Docker DNS Resolution Not Working: Fixes
Fix DNS resolution failures inside Docker containers. Covers systemd-resolved conflicts, custom DNS configuration, Docker network DNS, and Alpine-specific issues.
Docker Containers Can't Communicate: Fixes
Fix connectivity issues between Docker containers. Covers network isolation, DNS resolution, port mapping errors, firewall conflicts, and cross-stack networking.
Grocy: Barcode Scanner Not Working — Fix
Fix Grocy barcode scanning issues including camera not opening, HTTPS requirements, Home Assistant incompatibility, and QR code support. Step-by-step fix.
Kavita: Metadata Not Matching — Fix
Fix Kavita metadata not matching, covers not showing, or series not grouping correctly. Covers naming conventions, scan issues, and API keys — tested fix.
Minecraft Server: Lag and Performance — Fix
Fix Minecraft server lag with JVM tuning, chunk optimization, mob limiting, and hardware recommendations for smooth self-hosted gameplay. Step-by-step fix.
Moodle: Slow Performance — Fix
Fix slow Moodle performance in Docker. Covers PHP-FPM tuning, Redis caching, database optimization, and cron configuration for self-hosted Moodle. Fixed.
Self-Hosted SSL Certificate Errors: Fixes
Fix common SSL and TLS certificate errors for self-hosted services. Covers Let's Encrypt failures, reverse proxy issues, expired certs, and mixed content warnings.
Zammad Elasticsearch Errors: Fix Guide
Fix Zammad Elasticsearch connection errors, indexing failures, and search not working. Covers heap size, max_map_count, reindexing, and Docker configuration.
Ghost Docker: Migration Issues — Fix
Fix Ghost Docker migration errors during upgrades. Covers database schema issues, volume permissions, content path problems, and version pinning. Quick fix.
WordPress Docker: Slow Performance — Fix
Fix slow WordPress performance in Docker. Covers PHP-FPM tuning, MySQL optimization, volume mounts, caching, and OPcache configuration with prevention tips.
Firefly III: Import Not Working — Fix
Firefly III CSV and bank imports failing? Fix common import issues including Data Importer errors, duplicate detection, and GoCardless connection problems.
CalDAV Sync Not Working on Mobile — Fix
Fix CalDAV calendar and contact sync issues on iPhone and Android. Troubleshoot URL format, SSL certificates, authentication, and app configuration. Fixed.
Baikal: CardDAV Contacts Not Syncing — Fix
Fix Baikal CardDAV contacts sync failures on iOS, macOS, Android, and Thunderbird with solutions for .well-known redirects, SSL, and photo sync. Quick fix.
Self-Hosted Email Going to Spam: Fixes
Fix self-hosted email landing in spam. Diagnose SPF, DKIM, DMARC, PTR records, IP reputation, and content issues with step-by-step solutions and test tools.
Mailcow Not Receiving Email: Fixes
Fix mailcow not receiving incoming email. Diagnose MX records, port 25 blocking, Postfix issues, DNS, and SOGo sync problems step by step — here's the fix.
Mailu Docker Compose Errors: Fixes
Fix common Mailu Docker Compose errors — container crashes, port conflicts, TLS failures, DNS issues, and authentication problems step by step — tested fix.
FreshRSS: Feeds Not Updating — Fix
Fix FreshRSS feeds not updating automatically. Common causes include missing CRON_MIN, Docker cron issues, rate limiting, and feed parsing failures. Fixed.
Miniflux: Feed Import Not Working — Fix
Fix Miniflux OPML import errors, feed discovery failures, and subscription issues. Covers DNS problems, certificate errors, and encoding fixes — tested fix.
Matomo: GDPR Compliance Setup — Guide
Configure Matomo for GDPR compliance. Covers cookie consent, data anonymization, opt-out mechanisms, data retention, and privacy settings — here's the fix.
Plausible: Not Tracking Visits — Fix
Fix Plausible Analytics not tracking visits — common causes including script loading, CORS errors, ad blockers, and configuration issues. Step-by-step fix.
Homarr: Dashboard Not Loading — Fix
Fix Homarr dashboard not loading, showing blank page, or widgets failing to connect to your self-hosted services. Step-by-step fix with prevention tips.
Paperless-ngx: Consumption Folder Not Processing — Fix
Fix Paperless-ngx consumption folder not processing documents. Troubleshoot permissions, inotify limits, path configuration, and polling settings. Fixed.
Paperless-ngx: OCR Not Working — Fix
Fix Paperless-ngx OCR failures — documents showing no text content after processing. Covers Tesseract errors, language packs, permissions, and memory issues.
Stirling-PDF: Conversion Errors — Fix
Fix Stirling-PDF conversion failures, OCR issues, LibreOffice errors, and memory problems with Docker configuration solutions and image variant guidance.
Matrix Synapse: Federation Not Working — Fix
Fix Matrix Synapse federation issues including DNS configuration, .well-known setup, reverse proxy settings, and port 8448 connectivity problems. Quick fix.
Matrix Synapse: High Memory Usage — Fix
Fix Matrix Synapse high memory usage with PostgreSQL tuning, worker mode, room cleanup, and Docker memory configuration for stable operation — tested fix.
n8n Workflows Not Executing: Fix Guide
Fix n8n workflows that won't trigger or execute in Docker. Covers webhook URL config, execution settings, timezone mismatches, and Docker networking issues.
BorgBackup: Slow Backup Speed — Fix
Optimize BorgBackup performance by fixing slow backup speeds — compression tuning, chunking, SSH config, cache issues, and hardware bottlenecks. Quick fix.
Restic: Repository Locked — Fix
Fix the 'repository is already locked' error in Restic caused by interrupted backups, stale lock files, or concurrent operations. Step-by-step fix included.
Reverse Proxy 502 Bad Gateway: Causes and Fixes
Diagnose and fix 502 Bad Gateway errors when using Nginx Proxy Manager, Traefik, Caddy, or HAProxy with Docker containers. Includes root cause and prevention.
Traefik: SSL Certificate Not Generating — Fix
Resolve Traefik failing to generate Let's Encrypt SSL certificates due to DNS, port, or ACME configuration issues. Step-by-step fix with prevention tips.
Nginx Proxy Manager: SSL Not Renewing — Fix
Resolve Let's Encrypt SSL certificates failing to renew in Nginx Proxy Manager due to port or DNS issues. Covers root cause, exact commands, and prevention.
Traefik: Docker Containers Not Detected — Fix
Fix Traefik not discovering Docker containers due to socket permissions, network, or label configuration problems. Step-by-step fix with prevention tips.
Traefik: Dashboard Not Loading — Fix
Fix Traefik dashboard showing a blank page or refusing connections when accessing the web UI on port 8080. Covers root cause, exact commands, and prevention.
Nginx Proxy Manager: 502 Bad Gateway — Fix
Fix the 502 Bad Gateway error in Nginx Proxy Manager caused by wrong hostnames, ports, or Docker network issues. Step-by-step fix with prevention tips.
NPM: Default Site Showing Instead of App — Fix
Fix Nginx Proxy Manager showing its default page instead of routing to your app due to host or DNS configuration. Step-by-step fix with prevention tips.
Cloudflare Tunnel: Not Working — Fix
Fix Cloudflare Tunnel connection failures, 502 errors, services not loading, and DNS routing issues for self-hosted apps. Includes root cause and prevention.
Headscale: Nodes Not Connecting — Fix
Fix Headscale nodes not connecting, registration failures, MagicDNS issues, and DERP relay problems in self-hosted Tailscale. Step-by-step fix included.
WireGuard: Not Connecting — Fix
Fix WireGuard connection issues including handshake failures, no internet through tunnel, and peers not communicating. Includes root cause and prevention.
Grafana Dashboard Not Loading Data — Fix
Fix Grafana dashboards showing 'No data' or empty panels. Covers Prometheus data source, query issues, time range, and permission problems — here's the fix.
Prometheus High Memory Usage — Fix
Fix Prometheus consuming too much RAM in Docker. Covers retention settings, cardinality reduction, chunk size tuning, and storage optimization step by step.
Uptime Kuma Notifications Not Sending — Fix
Fix Uptime Kuma notifications not working. Covers SMTP configuration, Discord webhooks, Telegram bots, and common notification delivery issues — tested fix.
Portainer: Docker Socket Connection Error Fix
Fix Portainer Docker socket connection errors including permission denied, socket not found, and failed endpoint communication in Docker and Podman setups.
BookStack: LDAP Authentication Not Working — Fix
Fix BookStack LDAP login failures — covers filter syntax, TLS certificate issues, Docker variable escaping, and Active Directory configuration — tested fix.
Joplin Server: Sync Not Working — Fix
Fix Joplin Server sync failures — covers connection errors, sync target configuration, PostgreSQL issues, and SSL certificate problems with prevention tips.
Outline: Docker Not Starting — Fix
Fix Outline wiki failing to start in Docker — covers database connection errors, Redis auth issues, SECRET_KEY problems, and migration failures. Quick fix.
Nextcloud: Upload Size Limit — Fix
Fix Nextcloud upload size limits. Increase the maximum file upload size in PHP, nginx, Apache, and Docker configurations for large file uploads. Quick fix.
Syncthing: Not Connecting to Peers — Fix
Fix Syncthing connection issues: devices not connecting, sync stuck on 'Disconnected', relay problems, and firewall configuration for peer discovery guide.
Nextcloud Slow Performance: Fix Guide
Fix slow Nextcloud performance in Docker with Redis caching, PHP-FPM worker tuning, OPcache configuration, database optimization, and preview pre-generation.
Nextcloud Sync Not Working: Fix Guide
Fix Nextcloud desktop and mobile sync issues including file locking, WebDAV errors, slow uploads, and reverse proxy configuration problems — here's the fix.
AdGuard Home: DNS Not Resolving — Fix
Fix AdGuard Home DNS resolution issues: port conflicts, upstream failures, client bypass, and DHCP configuration problems. Includes root cause and prevention.
Pi-hole: High Memory Usage — Fix
Diagnose and fix Pi-hole's high memory usage caused by large blocklists, query logging, long-term data, and FTL database bloat in Docker deployments guide.
Pi-hole: Not Blocking Ads — Fix
Fix Pi-hole not blocking ads: DNS configuration issues, blocklist problems, client bypass, and upstream resolver conflicts. Includes root cause and prevention.
Jellyfin Remote Access Not Working: Fix Guide
Fix Jellyfin remote access issues including reverse proxy configuration, WebSocket errors, port forwarding, BaseURL setup, and SSL certificate problems.
Jellyfin Transcoding Not Working: Fix Guide
Fix Jellyfin transcoding failures including hardware acceleration setup, codec errors, and Docker GPU passthrough for Intel and NVIDIA with prevention tips.
Plex Not Finding Media: Fix Guide
Fix Plex not detecting your movies, TV shows, or music library. Covers Docker volume mounts, file naming conventions, permissions, and library scanner setup.
Docker Compose Common Errors and Fixes
Fix the most common Docker Compose errors including port conflicts, volume permissions, network issues, and YAML syntax problems. Step-by-step fix included.