Manual installation instructions

These intructions are inspired from a standard django/gunicorn/postgresql instructions (for example)

!!! warning Be sure to use pyton3.9 and pip related to python 3.9. Depending on your distribution calling python or pip will use python2 instead of pyton 3.9.

Prerequisites

Setup user: sudo useradd recipes

Get the last version from the repository: git clone https://github.com/vabene1111/recipes.git -b master

Move it to the /var/www directory: mv recipes /var/www

Change to the directory: cd /var/www/recipes

Give the user permissions: chown -R recipes:www-data /var/www/recipes

Create virtual env: python3.9 -m venv /var/www/recipes

Install postgresql requirements

sudo apt install libpq-dev postgresql

###Install project requirements

Using binaries from the virtual env:

/var/www/recipes/bin/pip3.9 install -r requirements.txt

Setup postgresql

sudo -u postgres psql

In the psql console:

CREATE DATABASE djangodb;
CREATE USER djangouser WITH PASSWORD 'password';
GRANT ALL PRIVILEGES ON DATABASE djangodb TO djangouser;
ALTER DATABASE djangodb OWNER TO djangouser;

--Maybe not necessary, but should be faster:
ALTER ROLE djangouser SET client_encoding TO 'utf8';
ALTER ROLE djangouser SET default_transaction_isolation TO 'read committed';
ALTER ROLE djangouser SET timezone TO 'UTC';

--Grant superuser right to your new user, it will be removed later
ALTER USER djangouser WITH SUPERUSER;

Download the .env configuration file and edit it accordingly.

wget https://raw.githubusercontent.com/vabene1111/recipes/develop/.env.template -O /var/www/recipes/.env

Things to edit:

SECRET_KEY: use something secure.
POSTGRES_HOST: probably 127.0.0.1.
POSTGRES_PASSWORD: the password we set earlier when setting up djangodb.
STATIC_URL, MEDIA_URL: these will be in /var/www/recipes, under /staticfiles/ and /mediafiles/ respectively.

Initialize the application

Execute export $(cat /var/www/recipes/.env |grep "^[^#]" | xargs) to load variables from /var/www/recipes/.env

Execute /python3.9 manage.py migrate

and revert superuser from postgres: sudo -u postgres psql and ALTER USER djangouser WITH NOSUPERUSER;

Generate static files: python3.9 manage.py collectstatic and remember the folder where files have been copied.

Setup web services

gunicorn

Create a service that will start gunicorn at boot: sudo nano /etc/systemd/system/gunicorn_recipes.service

And enter these lines:

[Unit]
Description=gunicorn daemon for recipes
After=network.target

[Service]
Type=simple
Restart=always
RestartSec=3
User=recipes
Group=www-data
WorkingDirectory=/var/www/recipes
EnvironmentFile=/var/www/recipes/.env
ExecStart=/var/www/recipes/bin/gunicorn --error-logfile /tmp/gunicorn_err.log --log-level debug --capture-output --bind unix:/var/www/recipes/recipes.sock recipes.wsgi:application

[Install]
WantedBy=multi-user.target

Note: -error-logfile /tmp/gunicorn_err.log --log-level debug --capture-output are usefull for debugging and can be removed later

Note2: Fix the path in the ExecStart line to where you gunicorn and recipes are

Finally, run sudo systemctl enable gunicorn_recipes and sudo systemctl start gunicorn_recipes. You can check that the service is correctly started with systemctl status gunicorn_recipes

nginx

Now we tell nginx to listen to a new port and forward that to gunicorn. sudo nano /etc/nginx/conf.d/recipes.conf

And enter these lines:

server {
    listen 8002;
    #access_log /var/log/nginx/access.log;
    #error_log /var/log/nginx/error.log;

    # serve media files
    location /staticfiles {
        alias /var/www/recipes/staticfiles;
    }
    
    location /mediafiles {
        alias /var/www/recipes/mediafiles;
    }

    location / {
        proxy_set_header Host $http_host;
        proxy_pass http://unix:/var/www/recipes/recipes.sock;
    }
}

Note: Enter the correct path in static and proxy_pass lines.

Reload nginx : sudo systemctl reload nginx

4.1 KiB Raw Blame History