Docker + local

Run the database in Docker and the frontend and backend locally.

On Debian/Ubuntu install these dependencies.

RUN apt-get update \
    && apt-get -y install --no-install-recommends \
    sudo \
    wget \
    curl \
    git \
    make \
    strace \
    clang \
    lld \
    libpq-dev \
    libssl-dev \
    pkg-config \
    postgresql-client

Install Docker

Install Docker for your host OS.

Installing Node + Npm

Make sure node, in the version as required for PermaplanT, is installed, you may use to easily install multiple versions of node nvm, use apt or download node directly. We use 20.10 (see ci/container-images/permaplant-node/Dockerfile).

Install Rust

Follow the steps to install Rust using rustup. We use Rust 1.81 (see ci/container-images/permaplant-rust/Dockerfile).

Run the database

This runs the Postgis database and PgAdmin.

cd docker
docker compose up -d

WSL2

If you use WSL2 please make sure that the project is in the Linux file system and not in /mnt/c. Otherwise you may face issues because: - Linux uses a completely different system for file ownerships and rights - Linux file names are case-sensitive - Linux uses different characters to represent line breaks (LF vs CRLF).