NeoAnd/netbox
1
0
Fork 0
mirror of https://github.com/netbox-community/netbox.git synced 2025-08-02 05:46:25 -06:00
Code Issues Actions 9 Packages Projects Releases Wiki Activity

Add example using nginx + uwsgi

Browse Source 
Supplemental instructions on using uwsgi as the app host.
This commit is contained in:
Matthew Hawkins 2017-07-12 12:08:26 +10:00 committed by GitHub
parent dc77400ab1
commit c546206c3a
1 changed files with 62 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

62
docs/installation/web-server.md
View File

@ -133,5 +133,67 @@ Then, restart the supervisor service to detect and run the gunicorn service:
At this point, you should be able to connect to the nginx HTTP service at the server name or IP address you provided. If you are unable to connect, check that the nginx service is running and properly configured. If you receive a 502 (bad gateway) error, this indicates that gunicorn is misconfigured or not running.
# nginx + uwsgi installation
uwsgi is an alternative to using gunicorn + supervisord. It has native proxy support via the WSGI protocol in nginx.
```no-highlight
# apt-get install uwsgi uwsgi-plugin-python3
```
Add a site to uwsgi in `/etc/uwsgi/apps-available/netbox.ini`:
```ini
[uwsgi]
chdir = /var/www/netbox/netbox
stats = 127.0.0.1:9191
wsgi-file = netbox/wsgi.py
master = true
processes = 4
threads = 2
uid = www-data
socket = /run/uwsgi/netbox.sock
chown-socket = www-data:www-data
chmod-socket = 660
vacuum = true
```
Symlink it in `/etc/uwsgi/apps-enabled`:
```no-highlight
# cd /etc/uwsgi/apps-enabled
# ln -s ../apps-available/netbox.ini .
```
For the nginx site setup in `/etc/nginx/sites-available/netbox`, a minimal example is:
```nginx
server {
listen 443 ssl default_server;
listen [::]:443 ssl default_server;
ssl_certificate /etc/ssl/certs/netbox.crt;
ssl_certificate_key /etc/ssl/private/netbox.key;
server_name $hostname;
keepalive_timeout 75;
root /var/www/netbox;
access_log /var/log/nginx/netbox.access combined;
location /static/ {
alias /var/www/netbox/netbox/static/;
}
location / {
uwsgi_pass unix:///run/uwsgi/netbox.sock;
include uwsgi_params;
}
}
```
Finally, test configs & start the nginx and uwsgi services:
```no-highlight
# uwsgi --show-config
# nginx -t
# service uwsgi start
# service nginx start
```
!!! info
Please keep in mind that the configurations provided here are bare minimums required to get NetBox up and running. You will almost certainly want to make some changes to better suit your production environment.