Support
Troubleshooting Guide
Common Issues and Solutions
- Issue: Service Won't Start bash
# Check Docker status
sudo systemctl status docker
# Check container logs
docker-compose logs tileserver
# Check port conflicts
netstat -tulpn | grep :8080
# Verify configuration
docker-compose config
# Solution: Fix configuration and restart
nano config/config.yml
docker-compose down && docker-compose up -d
- Issue: Slow Tile Rendering bash
# Check system resources
htop
iostat -x 1
docker stats
# Check database performance
docker-compose exec postgres psql -U postgres -d tileserver -c "
SELECT query, calls, total_time, mean_time
FROM pg_stat_statements
ORDER BY total_time DESC
LIMIT 10;"
# Solution: Optimize database and increase cache
- Issue: Cache Not Working bash
# Check Redis connectivity
docker-compose exec redis redis-cli ping
# Check cache configuration
docker-compose exec tileserver cat /app/config/config.yml | grep -A 10 cache
# Check cache stats
docker-compose exec redis redis-cli info stats
# Solution: Restart Redis and clear cache
docker-compose restart redis
docker-compose exec redis redis-cli FLUSHALL
- Support Contacts and Resources
Internal Support
-
DevOps Team: devops@yourcompany.com
-
Infrastructure Team: infrastructure@yourcompany.com
-
On-call Support: +1-555-0123 (24/7)
External Resources
-
Official Documentation: https://tileserver.org/docs/
-
Community Forum: https://community.tileserver.org/
-
GitHub Issues: https://github.com/tileserver/tileserver/issuesConnect your Github account
-
Stack Overflow: Tag tileserver
- Emergency Procedures bash
# Emergency restart
docker-compose restart
# Emergency rollback
docker-compose down
docker-compose up -d --scale tileserver=1
# Emergency cache clear
docker-compose exec redis redis-cli FLUSHALL
Log Analysis
Common Log Patterns
bash
# Error analysis
docker-compose logs tileserver | grep -i error | tail -50
# Performance issues
docker-compose logs tileserver | grep -E "(slow|timeout|memory)"
# Security concerns
docker-compose logs tileserver | grep -E "(401|403|attack|blocked)"