Skip to content

Latest commit

 

History

History
84 lines (54 loc) · 2.96 KB

Dependencies.md

File metadata and controls

84 lines (54 loc) · 2.96 KB

Dependencies

Our project has a few system-level-dependencies, which are generally useful and a few which are only used for some parts of the project. If you get stuck or have any questions, feel free to contact us. We are happy to help.

General

OS

We recommend using a Linux-based OS, as we have not tested the project on Windows or Mac. ("There be dragons", but we will try to improve this part if you show us where we fail) If you are using Windows, use WSL to run Linux on Windows.

Please make sure that your OS is up-to-date, before we start. (Trust me, this has fucked over multiple people...) On Ubuntu this is as easy as running sudo apt update && sudo apt upgrade.

Git

You probably already have it, but if not, install it using your package manager.

Docker

We deploy our project using docker containers. This means, that if you have docker installed, you can:

  • Run a part of the project like the server, our tileserver or the search engine meilisearch locally
  • Test deployment-linked changes locally

To get started with docker, you can follow the official tutorial.

Specific (most of these are only needed for development of said part)

Data Processing

Python3

The data processing scripts are written in python, and they implicitly depend on a recent version of python (~3.12). If you don't meet this requirement, head over to the python website and download the latest version.

Server

Python3

The server does have some scripts, which are written in python, and they implicitly depend on a recent version of python (>=3.12). If you don't meet this requirement, head over to the python website and download the latest version.

Rust

Our server is written in Rust. To get started with Rust, you can follow the official tutorial. To install Rust, you can use rustup.

Feedback

Rust

Our server is written in Rust. To get started with Rust, you can follow the official tutorial. To install Rust, you can use rustup.

OpenSSL

The server uses OpenSSL to verify TLS certificates.

On Debian-based systems like Ubuntu, you can install it with:

sudo apt-get install build-essential pkg-config openssl libssl-dev

Webclient

NodeJS

We use NodeJS for the webclient. Setting up NodeJS is a bit more complicated than setting up python/rust, but it is still pretty easy.

  • On Linux, you can get it through your favorite package manager. You normally should need to install nodejs and pnpm.
  • On WSL, use this guide and this guide