developers_setup.md

Backroll developers’ setup

Here is our recommended developers’ setup to contribute to Backroll.

WSL

If you are on Windows, you can work on linux throught WSL.

Docker

Windows & Linux desktops

If you want to work locally, install Docker Desktop.

To use Docker in WSL, check your WSL integration settings : Settings > Resources > WSL integration.

Linux server

If you plan to work remotely on a linux server :

• install Docker
• install Docker Compose

Visual Studio Code

Install Visual Studio Code.

Extensions

Windows

If you are on Windowns, install the WSL extension. Connect to WSL with Visual Studio Code before cloning the Backroll repository.

Remote developement

If you plan to work remotely on a server, install the remote connexion extensions :

• Remote - SSH
• Remote - SSH: Editing Configuration Files
• Remote Explorer

Docker

You can install the Docker extension. It provides a UI to manage containers and other Docker stuff directly into Visual Studio Code. However, it may no guess the full docker compose command you used to set up your containers, so just fallback to the command line.

KVM

To contribute to Backroll, you will need to have an hypervisor and some VMs to play with.

So let’s setup KVM :

• start with this beginners’ guide
• if libvirtd is not running, see this thread

Then create a VM :

• see this thread : note that virt-manager is a nice tool to quickly create a VM for development purposes

If Backroll and KVM are running on the same host (WSL or a linux computer), you can reach the hypervisor by using the special domain name host.docker.internal.