Skip to content

Acuparse Docker Installation Guide

Running Acuparse in Docker is currently in early but stable support.

The Acuparse container itself does contain a local database. Use acuparse/mariadb for best compatibility.

Acuparse is available on Docker Hub.

To use set your image to:

  • acuparse/acuparse (Docker Hub)
  • (GitLab Registry)

Docker Compose

Use Docker Compose to run Acuparse in production. A script is available to set up your host.


Automated Installation

  • Download the installer.

    curl -O
  • Run the installer

    • On a fresh Ubuntu/Debian system without Docker or Compose
    sudo bash install_docker full | tee ~/acuparse.log
    • On an existing system with Docker installed but not Compose
    sudo bash install_docker compose | tee ~/acuparse.log
    • On an existing system with Docker and Compose installed.

      • MacOS users should install Docker and Compose manually, then run the command below.
      sudo bash install_docker | tee ~/acuparse.log
  • Add your user to the Docker group

    sudo usermod -a -G docker $USER

Manual Installation

Install Docker and Docker Compose on your system before continuing.

  • Get Docker
  • Get Docker Compose

  • Download and install the Acuparse compose files to /opt/acuparse/.

    curl '' -o`

You MUST edit the acuparse.env file to set your SQL password before use!

Helper Script

A script is installed automatically to help assist with running your containers. If you installed the Docker Compose files manually, copy the script to /usr/local/bin.

mv acuparse /usr/local/bin
chmod +x /usr/local/bin/acuparse


acuparse start


acuparse restart


acuparse stop

To REMOVE ALL DATA and start over

acuparse destroy


Also updates the run script and the docker-compose config.

sudo acuparse update


acuparse logs



acuparse console


acuparse dbconsole


acuparse status


You must configure volumes for your SQL database, or it will be lost on container restart.

The default compose file will do this for you.

Local Bind Volumes

The following volumes are created in /opt/acuparse/volumes

  • /opt/acuparse/volumes/webcam
    • Copy your webcam images to this directory for use in Acuparse.
    • See Webcam details below
  • /opt/acuparse/volumes/backups
    • Acuparse Config and Database backups.
    • Also, mounted to the Database container; if you need to perform a restore.


When using a webcam with Acuparse, run the webcam scripts on the docker host. Then copy the images to /opt/acuparse/volumes/webcam instead of the default location /opt/acuparse/src/img/cam.

The container is not setup to run the webcam scripts directly or be accessed via SSH.


The automated backup script will run once daily and save backups to /opt/acuparse/volumes/backups.

Restore Database

Connect to your acuparse console and extract the archive

tar -xvf /var/opt/acuparse/backups/<BACKUPDATE>.tar.gz

Then connect to your acuparse dbconsole and restore your database

mysql -p$MYSQL_ROOT_PASSWORD acuparse < mysql.sql

Restore Config File

Connect to your acuparse console and extract the archive located in tar -xvf /var/opt/acuparse/backups/<BACKUPDATE>.tar.gz.

Copy your config file back cp config.php /opt/acuparse/src/usr/config.php