Install

Note

This document is about default procedure for a freshly created project. Some projects may have been changed by developers to involve less or more requirements, tasks and configurations.

Commonly a project should documentate everything for their specific needs but it is out of scope of Bireli documentation.

System requirements

A project will requires Python, pip, virtualenv, GNU make and a recent Node.js already installed and some system packages for installing and running.

Lists below are the required basic development system packages and some other optional ones.

Basic system requirements

Warning

Package names may differ depending your system.

  • Git;

  • Python >=3.11;

  • python-dev;

  • python-virtualenv;

  • gettext;

  • gcc;

  • make;

  • libjpeg;

  • libcairo2;

  • zlib;

  • libfreetype;

Hint

If your system does not have the right Python version as the default one, you should use something like pyenv to install it and then use pyenv local to set the correct project Python version to use.

On Linux distribution

You will install them from your common package manager like apt for Debian based distributions:

apt install python-dev python-virtualenv gettext gcc make libjpeg libcairo2 zlib libfreetype
On macOS

Recommended way is to use brew utility for system packages, some names can vary.

On Windows

Not supported, you probably can install some needed stuff but with some works on your own.

Optional system requirements

These ones are common extra requirements that some projects may use. You don’t need to take care of them for now.

For Postgresql client driver (psycopg2)

  • libpq;

For Mysql client driver

  • libmysqlclient-dev;

For M2Crypto

  • swig;

For Graphviz

  • graphviz;

  • libgraphviz-dev;

  • graphviz-dev;

Local deployment

A created project can be installed using a simple Makefile task:

make install

Now you need to build the frontend assets:

make frontend

If your project include application with translated URL patterns, you will need to build compiled translation file *.mo:

make mo

Note

Compiled translation files are commonly not blocking when missing but not for URL patterns that can lead to unexpected and troubling Http404 responses.

This is not a common usecase so you may avoid it if you are confident enough, at least this note is here so you’ll know.

When finished your project is ready to run.

Initial data

Note

Sorry there was previously a task to create some initial data but is was incompatible with the latest backend changes. We are working on a new solution but actually a new created project is basically blank.

At least you will need a super user:

make superuser

Quickstart

Once you already installed a Bireli project, you should have all needed requirements and you may just quickly do everything in a single command:

make install mo frontend superuser

Update

Later if you (or a new commit) introduced a new package or package version changes, you may use the following command to fully upgrade your local install (both backend and frontend):

make update

Or you can just update backend:

make update-backend

Or you can just update frontend:

make update-frontend

Warning

Don’t use the task install to update your install, it has been made for a fresh new install and include some other tasks that are longer to run and that could also lost some of your changes and data.

Cleaning

If you need to reset your local install you may use the following command:

make clean

However this will remove everything even your local data and you will need to install everything again. If you just need to clean some parts of your install you may see the Makefile Tasks for all the specific cleaning tasks.

Production deployment

This is out of scope of Bireli because there is just too many ways to deploy a project, you will have to add this layer on yourself into your project.