Trouble Shooting Admin Guide
Common issues with setup
Troubleshooting
Plugin Won’t Load
# Check Traefik logs:
docker logs traefik 2>&1 | grep pages-server
# Common issues:
# - Wrong module name in static config
# - Version number typo
# - Traefik not restarted after config change
SSL Certificates Not Generating
# Check these:
1. HTTP and HTTPS routers are on separate entrypoints
2. acme.json has correct permissions (600)
3. Email is valid in certificatesResolvers config
4. DNS propagation is complete (wait 15-60 mins)
5. Let's Encrypt rate limits not exceeded
Custom Domains Not Working
# Checklist:
1. Redis is running and accessible
2. traefikRedisRouterEnabled: true
3. Redis provider is configured in static config
4. User visited pages URL first to register domain
5. DNS points to your Traefik IP
6. Wait 2-3 minutes for Traefik to pick up Redis changes
Sites Loading Slowly
# Check Redis:
redis-cli ping # Should return PONG
# Increase cache TTL:
cacheTTL: 600
# Monitor Redis:
redis-cli monitor
Upgrading
To upgrade the plugin:
# Update version in traefik.yml:
experimental:
plugins:
pages-server:
moduleName: github.com/sqcows/pages-server
version: v0.1.2 # New version
# Restart Traefik:
docker restart traefik