diff options
| author | Daniel Schadt <kingdread@gmx.de> | 2025-06-12 20:28:37 +0200 |
|---|---|---|
| committer | Daniel Schadt <kingdread@gmx.de> | 2025-06-12 20:28:37 +0200 |
| commit | abba548d84fa66bd7ac81683d3a70611cd6a8a3b (patch) | |
| tree | 9343994c998cc84970a92510626b3a62e3fa46d9 /doc | |
| parent | cf25779d218a4ace062f3c0549c0f2901a0c2d6a (diff) | |
| parent | a52781d2e039ccf9f984e06a4ff3aa5e02caff8b (diff) | |
| download | fietsboek-abba548d84fa66bd7ac81683d3a70611cd6a8a3b.tar.gz fietsboek-abba548d84fa66bd7ac81683d3a70611cd6a8a3b.tar.bz2 fietsboek-abba548d84fa66bd7ac81683d3a70611cd6a8a3b.zip | |
Merge branch 'postgres-support'
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/administration/installation.rst | 28 |
1 files changed, 21 insertions, 7 deletions
diff --git a/doc/administration/installation.rst b/doc/administration/installation.rst index b207784..a7c5c27 100644 --- a/doc/administration/installation.rst +++ b/doc/administration/installation.rst @@ -6,14 +6,16 @@ This document will outline the installation process of Fietsboek, step-by-step. Requirements ------------ -Fietsboek has the following requirements (apart from the Python modules, which -will be installed by ``pip``): +Fietsboek has the following requirements: +* A Linux system * Python 3.10 or later -* A `redis <https://redis.com/>`__ server, used for caching and temporary data -* (Optionally) an SQL database server like `PostgreSQL - <https://www.postgresql.org/>`__ or `MariaDB <https://mariadb.org/>`__ (if - SQLite is not enough) +* A `redis <https://redis.com/>`__ server +* (Optionally) an SQL database server: + * `PostgreSQL <https://www.postgresql.org/>`__ + +Other systems (such as BSD as operating system, or MariaDB as SQL server) might +work, but it is not tested. In addition, if you run on a different interpreter than CPython, you might need a working Rust toolchain (``rustc`` and ``cargo``) installed. This is because @@ -97,6 +99,18 @@ parser to process the GPX files: .. _issue #7: https://gitlab.com/dunj3/fietsboek/-/issues/7 +Optional: Install Database Drivers +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +If you decide to use a database other than SQLite, you must install the +required drivers: + +**PostgreSQL**: + +.. code:: bash + + .venv/bin/pip install psycopg2 + Configuring Fietsboek --------------------- @@ -119,7 +133,7 @@ other update tasks. You can use it to set up the initial database schema: instead of a specific version, you must also run ``.venv/bin/alembic -c production.ini upgrade head``. - See :doc:`../developer/updater` ("Furhter notes") for more information. + See :doc:`../developer/updater` ("Further notes") for more information. Adding an Administrator User ---------------------------- |