Add FAQ for webserver setups (fixes #1313)

This commit is contained in:
JoywinNeilLasrado 2026-04-09 07:54:18 +05:30
parent 0320f99b7e
commit 503f75d6fb

48
web_server_faq.md Normal file
View file

@ -0,0 +1,48 @@
# 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.