Installing Abilian SBE¶
Abilian SBE is a Python web application. It needs:
- Python 3.12 or later, managed with uv;
- a database: PostgreSQL or MariaDB, on an equal footing;
- Redis, for its task queue;
- for previews and search inside documents: Poppler, ImageMagick and LibreOffice;
- optionally, ClamAV, to scan uploaded files.
It runs as three processes: the web application, a worker for background tasks (conversions, e-mails, indexing) and a scheduler (the daily summary).
Three ways to run it¶
- On Hop3, a platform that builds and runs the application, its database and its Redis from the repository: the shortest way to a production site.
- On a server, step by step, on a Debian or Ubuntu machine.
- For development, on your own machine: see the developer guide.
Whichever you choose, Configuration lists the settings.
Moving an existing site¶
A site keeps two things: its database and its files, the folder data/files of its instance. To move a site to a new server, restore a dump of the database, copy the files, then run flask db upgrade, which brings the schema up to date, and flask reindex, which rebuilds the search index from the database.