Install from Debian package

This page describes how to install GISNav from a Debian package. The Debian package includes the GISNav CLI and the gisnav.service systemd service.

Install locally

GISNav CLI installs a containerized version of GISNav. For development you may want to install GISNav locally instead.

Todo

Separate CLI and service into dedicated Debian packages.

Prerequisites

You will need to have the Docker Compose plugin installed.

Install

Download the gisnav Debian package and install it using the below commands. You can edit the release string to match your needs.

Private Docker registry

You can make this process quicker by building your own (potentially cross-platform) images on your development host and pulling them onto your Raspberry Pi 5 using a private container registry.

GISNAV_RELEASE=v0.68.1
wget https://github.com/hmakelin/gisnav/releases/download/${GISNAV_RELEASE}/gisnav-${GISNAV_RELEASE}_all.deb -O gisnav-${GISNAV_RELEASE}_all.deb
sudo dpkg -i ./gisnav-${GISNAV_RELEASE}_all.deb

Create Debian

See the Create Debian page if you want to create your own Debian package instead of using the hosted version.

After installing, you may want to prepare the key Docker containers before trying to deploy your services.

Warning: Long build time

Building the images will take a long time and use a lot of network bandwidth and storage space.

gnc create --build px4 gisnav

Uninstall

If you want to uninstall the service, use the below command:

sudo dpkg -r gisnav

Quick start

After installing, you may want to check out the CLI intro page, or try simulating GPS failure in a local SITL simulation.