10_install.rst

Install AlekSIS

From PyPI

In this section we will install AlekSIS with uWSGI and nGINX on Debian bullseye.

Filesystem locations

AlekSIS will need and use the following paths:

• /etc/aleksis for configuration files
• /var/lib/aleksis/media for file storage (Django media)
• /var/backups/aleksis for backups of database and media files
• /usr/local/share/aleksis/static for static files
• /usr/local/share/aleksis/node_modules for frontend dependencies

You can change any of the paths as you like.

Prerequisites

For an installation on a dedicated server, the following prerequisites are needed:

• Debian 11
• PostgreSQL
• Redis
• uWSGI
• nginx
• Python 3.9
• Some system dependencies to build Python modules and manage frontend files
• The aforementioned paths

Install system packages

Install some packages from the Debian package system.

apt install uwsgi \
            uwsgi-plugin-python3 \
            nginx-full \
            python3 \
            python3-dev \
            libpq-dev \
            yarnpkg \
            python3-virtualenv \
            chromium \
            redis-server \
            postgresql

Create PostgreSQL user and database

Generate a secure password for the database, then create the user and database.