Installing and launching Axxon One using Docker

General information about the Docker image and container

Installing the Docker server

To install and launch Axxon One using Docker, do the following:

1. Install Docker using the official manuals:
   • Debian: https://docs.docker.com/engine/install/debian/.
   • Ubuntu: https://docs.docker.com/engine/install/ubuntu/.
     

     Note

     Minimum requirements to launch Axxon One using Docker on Ubuntu:

     • dual-core CPU;
     • 4 GB RAM;
     • 200 GB HDD.
   • Other distribution packages: https://docs.docker.com/engine/install/.
2. Download the latest version of the Axxon One Docker image using the following command:
   

   sudo docker pull axxonsoft/axxon-one:latest

   Attention!

   The Axxon One failover build of the Docker image is available. If necessary, AxxonSoft technical support specialists can provide it.

3. Launch Docker using the following command:
   

   sudo docker run axxonsoft/axxon-one:latest

   Note

   If you need to install an earlier version of the Axxon One Docker image:

   1. Open the link to select the required Axxon One Docker image.

   2. Next to the required Docker image, click the button to copy the command.
      Example of the command:

      sudo docker pull axxonsoft/axxon-one:2.0.10.42

   3. Paste the copied command into the terminal and run it.

   4. Launch Docker using the following command:

      sudo docker run <image version>

      For example:

      sudo docker run axxonsoft/axxon-one:2.0.10.42

Starting Axxon One

After installation, you can connect to the Docker server with the separately installed Axxon One client. To do this, when starting the client, enter the IP address of the Docker server, login, and password in the authorization window (when you start Axxon One for the first time, enter the following login and password: root/root). You can connect to the Docker server using the Flatpak package as well (see Running the client as Flatpak).

List of useful commands:

• Determine the IP address to connect to:
  

  docker inspect <container id> | grep "IPAddress"

• View the list of containers and their status:
  • Only active containers:
    

    docker ps

  • All containers (active and stopped):
    

    docker ps -a

• Check the availability of the server:
  

  ping <ip address>

• View the running processes:
  

  docker top <container name>

• Start the container:
  

  docker start <container_id>

• Check the status of the container:
  

  docker ps

• Stop the container:
  

  docker stop <container_id>

Installing and starting Axxon One using Docker is complete.

Additional information

Directory inside the container

Directory is mounted inside the container:

/var/lib/docker/volumes/<volume_id>

You can change the path upon request via AxxonSoft technical support specialists.
To receive the volume_id value, use the command:

docker inspect <container_id>

Collecting the support package in the Docker container

To collect the support package, do the following:

1. First, find out the ID of the Docker container using the command:
   

   docker ps -a

2. Get access to the container terminal (container must be running):
   

   docker exec -it <container_id> sh

   where <container_id> is the Docker container ID.
3. Go to the Axxon One bin directory:
   

   cd /opt/AxxonSoft/AxxonOne/bin

4. Run the command:
   

   ./start_app support /data

   This initiates the process of creating the support package, which will be saved in the data directory.
5. Exit the terminal using the command:
   

   exit

6. Go to the /var/lib/docker/volumes/<volume_id>/data directory, which is configured for file exchange between the container and the host. The completed support package will be located in this directory.

Collecting the support package in the Docker container is complete.