Set up your development environment

Docs
1

The following section walks you through the necessary steps to set up your environment.
It is recommended to spin up a clean Ubuntu VM for these steps as it is always good to perform experiments in an isolated development environment.
Follow the steps in Set up an Ubuntu VM with Multipass to do this.

Create a project directory

Create a project directory with

mkdir ~/go-dqlite-demo
cd ~/go-dqlite-demo

This creates a folder called go-dqlite-demo in your home directory and enters it. All project files will be put in this directory.

Install the Dqlite tooling

On a Debian-based system, you can get the latest development release from Dqlite’s development PPA. First add the PPA repository:

sudo add-apt-repo ppa:dqlite/dev
sudo apt update

Then install the library:

sudo apt install libdqlite-dev

If you are not using a Debian-based system, you must build libdqlite from source. See Build for instructions on how to do this.

Install Go

Download and install the latest version of Go following the steps outlined in the Go documentation.
You can verify that everything is installed correctly by typing the following command in your terminal:

> go version
go version go1.21.1 linux/amd64

Check that the output matches the version that you downloaded earlier.

In your project folder, create a mod file with:

go mod init go-dqlite-demo

Install the application bindings for go-dqilite/app with:

go get github.com/canonical/go-dqlite/app

Read more about Go mod files in the Go documentation.

Install a C compiler

A C compiler is required for the package to build. Install gcc with:

sudo apt install gcc

You should now be all set to start your first Go application. Continue with Create an example application.