This project is still in an experimental state and may be unstable. Proceed at your own risk.

First, install the dependencies. If you already have Python & pip, you can install all the required Python modules with:

pip install -r requirements.txt

Then, download and unzip the latest release and follow these steps to initialize the site:

Generate a secret key

python generatekey

Configure the site URL

Replace <URL> with the URL of your website.

python configureurl <URL>

Create the database

python migrate

Collect the static files

These commands will compile and collect the static files (CSS, JS, etc).

python compilestatic
python collectstatic --noinput

Create an administrator account

You will be prompted for a name, email, and password. This account is needed to access the /admin page. You can create multiple administrator accounts.

python createsuperuser

Enable HTTPS

If you want to enable HTTPS, run this command:

python https on

To disable it, run:

python https off

Finally, set up the server

To set up the server you will need Apache, Nginx or any other web server that supports Django. Make sure the web server has the necessary permissions to access all the relevant files. Also, create the media and log directories beforehand to avoid possible errors.

Apache example

Apache requires mod_wsgi to be installed.

<VirtualHost *:80>

    <Location /admin>
        LimitRequestBody 51000000

    Alias /static /var/www/
    <Directory /var/www/>
        Require all granted

    Alias /media  /var/www/
    <Directory /var/www/>
        Require all granted

    WSGIDaemonProcess my-site python-path=/var/www/
    WSGIProcessGroup my-site
    WSGIScriptAlias / /var/www/ process-group=my-site
    <Directory /var/www/>
            Require all granted

Nginx example

Nginx requires uwsgi to be installed.

server {
    listen 80;
    charset utf-8;

    location /admin {
        client_max_body_size 51M;

    location /favicon.ico {
        access_log off;
        log_not_found off;

    location /static {
        alias /var/www/;

    location /media  {
        alias /var/www/;

    location / {
        include uwsgi_params;

Don’t forget to run uwsgi:

uwsgi --socket --chdir /var/www/ --module MangAdventure.wsgi


First, install any new or updated dependencies:

pip install -U -r requirements.txt

Then, compile and collect the static files:

python compilestatic
python collectstatic --noinput

Finally, update the database:

python migrate