Skip to content

fix(server): default to 4 API workers and fix the WEB_SERVER_CONCURRENCY guidance #4385

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gantoine merged 3 commits into from
Sep 7, 2026
+3 −3
Merged

fix(server): default to 4 API workers and fix the WEB_SERVER_CONCURRENCY guidance #4385

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
003dfe2
docs(env): replace the WEB_SERVER_CONCURRENCY worker heuristic
Spinnich Sep 7, 2026
424d1eb
fix(server): default to 4 API workers instead of 1
Spinnich Sep 7, 2026
3767d1b
cleanup
gantoine Sep 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docker/init_scripts/init
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,7 @@ start_bin_gunicorn() {
--pid=/tmp/gunicorn.pid \
--forwarded-allow-ips="*" \
--worker-class uvicorn_worker.UvicornWorker \
--workers "${WEB_SERVER_CONCURRENCY:-1}" \
--workers "${WEB_SERVER_CONCURRENCY:-4}" \
--timeout "${WEB_SERVER_TIMEOUT:-300}" \
--keep-alive "${WEB_SERVER_KEEPALIVE:-2}" \
--max-requests "${WEB_SERVER_MAX_REQUESTS:-1000}" \
Expand Down
2 changes: 1 addition & 1 deletion env.template
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,7 @@ FORCE_COLOR=false # Force colored log output
NO_COLOR=false # Disable colored log output

# Web Server
WEB_SERVER_CONCURRENCY=1 # Number of worker processes (recommended: 2 × CPU cores + 1)
WEB_SERVER_CONCURRENCY=4 # Number of API worker processes, raise for several concurrent users
WEB_SERVER_TIMEOUT=300 # Timeout for web server requests in seconds
WEB_SERVER_KEEPALIVE=2 # Keep-Alive connection wait time in seconds
WEB_SERVER_MAX_REQUESTS=1000 # Maximum requests a worker processes before restarting
Expand Down
2 changes: 1 addition & 1 deletion examples/docker-compose.example.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ services:
- STEAMGRIDDB_API_KEY= # https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#steamgriddb
- HASHEOUS_API_ENABLED=true # https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#hasheous
- SCAN_WORKERS=2 # How many items you want scanned at once, we recommend 1 worker per CPU.
- WEB_SERVER_CONCURRENCY=3 # How many workers you want available for API calls and tasks we recommend 2 x CPU + 1
- WEB_SERVER_CONCURRENCY=4 # Workers for API calls, raise for several concurrent users
volumes:
- romm_resources:/romm/resources # Resources fetched from IGDB (covers, screenshots, etc.)
- romm_redis_data:/redis-data # Cached data for background tasks
Expand Down
Loading