Installing Paparazzi using Docker

In this tutorial will be installing Paparazzi using Docker. Docker is an open platform used to build, ship, and run distributed applications.

This instructions are for Debian. If you use another Linux distribution, check the installation instructions on the Docker Page.

Docker is supported on the following versions:

• Debian Stretch (64 bits)
• Debian 8.0 Jessie (64 bits)
• Debian 7.7 Wheezy (64 bits)

Check that your kernel version is 3.10 or newer. Kernels older than 3.10 lack some of the features required to run Docker containers. These older versions are known to have bugs which cause data loss and frequently panic under certain conditions.

To check your kernel version, type in a terminal

  $ uname -r

If is older than 3.10, please update it.

• Purge any older versions of Docker.

   $ sudo apt-get remove docker docker-engine docker.io

• Update package information, ensure that APT works with the https method, and that CA certificates are installed. If you are using Jessie or Stretch use this:

   $ sudo apt-get update
   $ sudo apt-get install apt-transport-https ca-certificates curl gnupg2 software-properties-common

If you are using Wheezy use this:

   $ sudo apt-get update    
   $ sudo apt-get install apt-transport-https ca-certificates curl gnupg2 python-software-properties

• Add the new GPG key

   $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -

• Open the /etc/apt/sources.list.d/docker.list file in your favorite editor. If the file doesn’t exist, create it.

• Remove any existing entries.

• Add an entry for your Debian operating system.

On Debian Stretch

  deb [arch=amd64] https://download.docker.com/linux/debian stretch stable

On Debian Jessie

  deb [arch=amd64] https://download.docker.com/linux/debian jessie stable

On Debian Wheezy

  deb [arch=amd64] https://download.docker.com/linux/debian wheezy stable

• Save and close the file.

• Update the APT package index

  $ sudo apt-get update

• Install Docker.

  $ sudo apt-get install docker-ce

• Start the docker daemon.

  $ sudo service docker start

• Verify docker is installed correctly.

  $ sudo docker run hello-world

If displays a message like this

  Unable to find image 'hello-world:latest' locally
  latest: Pulling from library/hello-world
  535020c3e8ad: Pull complete
  af340544ed62: Pull complete
  Digest: sha256:a68868bfe696c00866942e8f5ca39e3e31b79c1e50feaee4ce5e28df2f051d5c
  Status: Downloaded newer image for hello-world:latest
  
  Hello from Docker.
  This message shows that your installation appears to be working correctly.
  
  To generate this message, Docker took the following steps:
   1. The Docker Engine CLI client contacted the Docker Engine daemon.
   2. The Docker Engine daemon pulled the "hello-world" image from the Docker Hub.
   3. The Docker Engine daemon created a new container from that image which runs the
      executable that produces the output you are currently reading.
   4. The Docker Engine daemon streamed that output to the Docker Engine CLI client, which sent
   it
   to your terminal.
   
  To try something more ambitious, you can run an Ubuntu container with:
   $ docker run -it ubuntu bash
  
  Share images, automate workflows, and more with a free Docker Hub account:
   https://hub.docker.com
  
  For more examples and ideas, visit:
   https://docs.docker.com/userguide/

Docker is succesfully installed.

• Clone the official Paparazzi repository

  $ git clone https://github.com/paparazzi/paparazzi.git

• Enter the docker directory in the cloned Paparazzi repository

  $ cd paparazzi/docker

• Build the Paparazzi docker image

  $ sudo make build

• Make the Paparazzi binaries

  $ sudo make bash
  $ make
  $ exit

• After this, you can run Paparazzi by typing in a terminal

  $ sudo make paparazzi

Any modification in the cloned Paparazzi repository will be reflected in the Paparazzi docker image.