Document installation using uwsgi as application host #1095

Closed
opened 2025-12-29 16:28:45 +01:00 by adam · 1 comment
Owner

Originally created by @hawko2600 on GitHub (Jul 12, 2017).

Issue type: documentation

Python version:
NetBox version:

Running netbox under anything other than gunicorn is currently undocumented. I've added simple steps to the web-server.md for using uwsgi as the app host instead & will include the pull request below.

I've currently kept it separate, though there's grounds to potentially merge the nginx configuration bits with the current nginx setup as essentially all that changes is which proxy function to use.

The setup is identical to the gunicorn example; nginx loads the static files and uwsgi takes the dynamic parts; I've also left out advanced config like high availability and caching as an exercise for the reader.

Originally created by @hawko2600 on GitHub (Jul 12, 2017). <!-- Please note: GitHub issues are to be used only for feature requests and bug reports. For installation assistance or general discussion, please join us on the mailing list: https://groups.google.com/forum/#!forum/netbox-discuss Please indicate "bug report" or "feature request" below. Be sure to search the existing set of issues (both open and closed) to see if a similar issue has already been raised. --> ### Issue type: documentation <!-- If filing a bug, please indicate the version of Python and NetBox you are running. (This is not necessary for feature requests.) --> **Python version:** **NetBox version:** <!-- If filing a bug, please record the exact steps taken to reproduce the bug and any errors messages that are generated. If filing a feature request, please precisely describe the data model or workflow you would like to see implemented, and provide a use case. --> Running netbox under anything other than gunicorn is currently undocumented. I've added simple steps to the web-server.md for using uwsgi as the app host instead & will include the pull request below. I've currently kept it separate, though there's grounds to potentially merge the nginx configuration bits with the current nginx setup as essentially all that changes is which proxy function to use. The setup is identical to the gunicorn example; nginx loads the static files and uwsgi takes the dynamic parts; I've also left out advanced config like high availability and caching as an exercise for the reader.
adam closed this issue 2025-12-29 16:28:45 +01:00
Author
Owner

@jeremystretch commented on GitHub (Jul 12, 2017):

I've limited the configuration docs to cover only gunicorn because it is sufficient to get an instance of NetBox up and running. Alternative applications (e.g. uWSGI) are supported but their configuration is documented elsewhere. We want to avoid expanding the example installation in the documentation any further because it would increase the degree of time and effort to maintain the docs over time.

@jeremystretch commented on GitHub (Jul 12, 2017): I've limited the configuration docs to cover only gunicorn because it is sufficient to get an instance of NetBox up and running. Alternative applications (e.g. uWSGI) are supported but their configuration is [documented elsewhere](https://docs.djangoproject.com/en/1.11/howto/deployment/wsgi/uwsgi/). We want to avoid expanding the example installation in the documentation any further because it would increase the degree of time and effort to maintain the docs over time.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/netbox#1095