1   Introduction

This is the documentation for how to install the CARRIDA MobileLPR server using Apache HTTP on an Ubuntu/Debian Linux system. Note that the server can be set up on any web server that supports WSGI.

2   Setting up the Web server

A WSGI capable web server is required to run the backend. For instance, Apache with mod_wsgi or NGNIX with uwsgi. On Linux, the package libapache2-mod-wsgi-py3 needs to be installed if Apache HTTP is used, while for NGNIX uwsgi will be needed. Furthermore, the files need to be copied to the server and all configuration files have to be created.

On Ubuntu or Debian, the installation for MobileLPR with Apache HTTP could look like this:

sudo apt install apache2 libapache2-mod-wsgi-py3
a2enmod wsgi
nano /etc/apache2/site-available/mobilelpr.conf
a2ensite mobilelpr.conf

Afterwards, the server should be restarted. The mobilelpr.conf file could look similiar to this:

WSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py
WSGIPythonHome /path/to/venv
WSGIPythonPath /path/to/mysite.com

<Directory /path/to/mysite.com/mysite>
    <Files wsgi.py>
        Require all granted
    </Files>
</Directory>

However, the setup.sh script should be run on first use. It will setup the application and print a sample apache configuration that can be used. The script also updates the application and can be re-run.

For more information see https://django.readthedocs.io/en/stable/howto/deployment/wsgi/modwsgi.html .