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