docker

Docker Installation and Usage

This is the preferred method of deploying and operating the Deadeye system. Docker is readily available on most, if not all, Linux distributions used on vision coproccessors.

Installation

We'll use the Docker Compose tool to deploy and operate Deadeye. The example commands below work on an Orange Pi running their Ubuntu jammy server image.

$ # install commonly required packages
$ sudo apt install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

# add the docker repository signing key
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# add the docker repository
$ echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# update the package lists
$ sudo apt update

# install docker
$ sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Docker permission

Add the account you are using (orangepi in our case) to the docker group.

$ sudo usermod -a -G docker orangepi
$ # login again to take effect

Docker Compose

Edit the docker-compose.yaml file as appropriate for your system. Select the docker image tags to use and edit the lines containing:

daemon:
  image: j3ff/deadeye-daemon:<TAG>
admin:
  image: j3ff/deadeye-admin:<TAG>
web:
  image: j3ff/deadeye-web:<TAG>

There are a number of environment variables beginning with DEADEYE_ that you may need to edit.

systemd

The Deadeye containers are run using systemd instead of normal container restart policies to work around Docker issues with camera device names.

Edit and install the deadeye.service systemd service definition as appropriate for your system, for example:

Environment="DOCKER_COMPOSE_FILE=/home/orangepi/deadeye/docker-compose.yml"
Environment="CAMERA_PATH=/dev/v4l/by-id/usb-Microsoft_Microsoft®_LifeCam_HD-3000-video-index0"

Install in /etc/systemd/system/deadeye.service and reload systemd services:

systemctl daemon-reload

Operation

Start the Deadeye containers with:

sudo systemctl start deadeye

Stop the Deadeye containers with:

sudo systemctl stop deadeye

View container logs:

# in directory containing docker-compose.yaml
docker compose logs -f

# or alternatively, where SERVICE is one of: admin, daemon, web
docker compose logs $SERVICE

Updating the containers to a new version:

sudo systemctl stop deadeye

# in directory containing docker-compose.yaml
# edit the docker image tag(s) in docker-compose.yaml
docker compose pull

# it's a good idea to recreate the docker network
docker compose down

sudo systemctl start deadeye

Clean up old docker images and containers.

docker system prune