web_server_faq.md

Webserver Setup FAQ

General Setup Questions

Q: What web server should I use?

A: You can use Nginx, Apache, or any reverse proxy that supports forwarding HTTP headers.

Q: How do I set up SSL/TLS?

A: Use a reverse proxy like Nginx to handle SSL. See the main README for detailed setup instructions.

Q: What are the system requirements?

A: Check the main README for Python, database, and server requirements.

Nginx Configuration

Q: How do I configure Nginx as a reverse proxy?

A: See the documentation folder for example Nginx configurations.

Q: What headers should I forward?

A: Forward headers like X-Forwarded-For, X-Forwarded-Proto, and Host.

Apache Configuration

Q: How do I set up Apache as a reverse proxy?

A: Enable mod_proxy and configure your VirtualHost accordingly.

Q: What modules do I need?

A: You'll need mod_proxy, mod_proxy_http, and mod_headers modules.

Troubleshooting

Q: Why am I getting 502 Bad Gateway errors?

A: Check that your backend application is running and accessible.

Q: How do I debug authentication issues?

A: Enable debug logging in your reverse proxy and check the application logs.

Q: Why aren't my static files loading?

A: Make sure your reverse proxy is properly forwarding paths. Check the documentation.

Performance

Q: How do I optimize caching?

A: Configure caching headers in your reverse proxy for static assets.

Q: Should I use HTTP/2?

A: Yes, it's recommended for better performance. Configure it in your reverse proxy.