Installation¶

Like many Python packages, you can use several methods to install PythonNest. PythonNest designed to run with python3.4.x+. The following packages are also required:

setuptools >= 3.0

djangofloor >= 0.18.0

Of course you can install it from the source, but the preferred way is to install it as a standard Python package, via pip.

Installing or Upgrading¶

Here is a simple tutorial to install PythonNest on a basic Debian/Linux installation. You should easily adapt it on a different Linux or Unix flavor.

Database¶

PostgreSQL is often a good choice for Django sites:

sudo apt-get install postgresql
echo "CREATE USER pythonnest" | sudo -u postgres psql -d postgres
echo "ALTER USER pythonnest WITH ENCRYPTED PASSWORD '5trongp4ssw0rd'" | sudo -u postgres psql -d postgres
echo "ALTER ROLE pythonnest CREATEDB" | sudo -u postgres psql -d postgres
echo "CREATE DATABASE pythonnest OWNER pythonnest" | sudo -u postgres psql -d postgres

Apache¶

I only present the installation with Apache, but an installation behind nginx should be similar. You cannot use different server names for browsing your mirror. If you use pythonnest.example.org in the configuration, you cannot use its IP address to access the website.

SERVICE_NAME=pythonnest.example.org
sudo apt-get install apache2 libapache2-mod-xsendfile
sudo a2enmod headers proxy proxy_http
sudo a2dissite 000-default.conf
# sudo a2dissite 000-default on Debian7
cat << EOF | sudo tee /etc/apache2/sites-available/pythonnest.conf
<VirtualHost *:80>
    ServerName $SERVICE_NAME
    Alias /static/ /var/pythonnest/static/
    ProxyPass /static/ !
    <Location /static/>
        Order deny,allow
        Allow from all
        Satisfy any
    </Location>
    Alias /media/ /var/pythonnest/data/media/
    ProxyPass /media/ !
    <Location /media/>
        Order deny,allow
        Allow from all
        Satisfy any
    </Location>
    ProxyPass / http://localhost:8130/
    ProxyPassReverse / http://localhost:8130/
    DocumentRoot /var/pythonnest/static
    ServerSignature off
</VirtualHost>
EOF
sudo mkdir /var/pythonnest
sudo chown -R www-data:www-data /var/pythonnest
sudo a2ensite pythonnest.conf
sudo apachectl -t
sudo apachectl restart

If you want to use SSL:

sudo apt-get install apache2 libapache2-mod-xsendfile
PEM=/etc/apache2/`hostname -f`.pem
# ok, I assume that you already have your certificate
sudo a2enmod headers proxy proxy_http ssl
openssl x509 -text -noout < $PEM
sudo chown www-data $PEM
sudo chmod 0400 $PEM

SERVICE_NAME=pythonnest.example.org
cat << EOF | sudo tee /etc/apache2/sites-available/pythonnest.conf
<VirtualHost *:80>
    ServerName $SERVICE_NAME
    RedirectPermanent / https://$SERVICE_NAME/
</VirtualHost>
<VirtualHost *:443>
    ServerName $SERVICE_NAME
    SSLCertificateFile $PEM
    SSLEngine on
    Alias /static/ /var/pythonnest/static/
    ProxyPass /static/ !
    <Location /static/>
        Order deny,allow
        Allow from all
        Satisfy any
    </Location>
    Alias /media/ /var/pythonnest/data/media/
    ProxyPass /media/ !
    <Location /media/>
        Order deny,allow
        Allow from all
        Satisfy any
    </Location>
    ProxyPass / http://localhost:8130/
    ProxyPassReverse / http://localhost:8130/
    DocumentRoot /var/pythonnest/static
    ServerSignature off
    RequestHeader set X_FORWARDED_PROTO https
</VirtualHost>
EOF
sudo mkdir /var/pythonnest
sudo chown -R www-data:www-data /var/pythonnest
sudo a2ensite pythonnest.conf
sudo apachectl -t
sudo apachectl restart

Application¶

Now, it’s time to install PythonNest:

sudo mkdir -p /var/pythonnest
sudo adduser --disabled-password pythonnest
sudo chown pythonnest:www-data /var/pythonnest
sudo apt-get install virtualenvwrapper python3.4 python3.4-dev build-essential postgresql-client libpq-dev
# application
sudo -u pythonnest -i
mkvirtualenv pythonnest -p `which python3.4`
workon pythonnest
pip install setuptools --upgrade
pip install pip --upgrade
pip install pythonnest psycopg2 gevent
mkdir -p $VIRTUAL_ENV/etc/pythonnest
cat << EOF > $VIRTUAL_ENV/etc/pythonnest/settings.ini
[database]
engine = django.db.backends.postgresql_psycopg2
host = localhost
name = pythonnest
password = 5trongp4ssw0rd
port = 5432
user = pythonnest
[global]
admin_email = admin@pythonnest.example.org
bind_address = localhost:8130
data_path = /var/pythonnest
debug = False
extra_apps =
language_code = fr-FR
protocol = http
secret_key = ap6WerC2w8c6SGCPvFM5YDHdTXvBnzHcToS0J3r6LeetzReng6
server_name = pythonnest.example.org
time_zone = Europe/Paris
[sentry]
dsn_url =
EOF
chmod 0400 $VIRTUAL_ENV/etc/pythonnest/settings.ini
# required since there are password in this file
pythonnest-manage migrate
pythonnest-manage collectstatic --noinput

Look at Operating the mirror for actually dumping the official mirror Pypi.

supervisor¶

Supervisor is required to automatically launch pythonnest:

sudo apt-get install supervisor
cat << EOF | sudo tee /etc/supervisor/conf.d/pythonnest.conf
[program:pythonnest_gunicorn]
command = /home/pythonnest/.virtualenvs/pythonnest/bin/pythonnest-gunicorn
user = pythonnest
EOF
sudo service supervisor stop
sudo service supervisor start

Now, Supervisor should start pythonnest after a reboot.

systemd¶

You can also use systemd to launch pythonnest:

cat << EOF | sudo tee /etc/systemd/system/pythonnest-gunicorn.service
[Unit]
Description=PythonNest Gunicorn process
After=network.target
[Service]
User=pythonnest
Group=pythonnest
WorkingDirectory=/var/pythonnest/
ExecStart=/home/pythonnest/.virtualenvs/pythonnest/bin/pythonnest-gunicorn
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
[Install]
WantedBy=multi-user.target
EOF
systemctl enable pythonnest-gunicorn.service
sudo service pythonnest-gunicorn start