Prerequisites

General Requirements

• A 64-bit operating system is strongly recommended.
• A minimum of 4GB RAM is strongly recommended to avoid system swaps, slowdowns and future expansions.
• Virtualization must be enabled in the BIOS to use Docker.
• Git to clone the project and perform updates directly from the tool.
• Latest version of Docker must already be installed which includes Docker compose, and auto-run on startup to run the stack. Follow the guide to your platform https://docs.docker.com/get-docker to install to use the built-in script tool.

ARM Devices

ARM devices (like Raspberry Pi and Apple Silicon) are required to install an emulation layer to run non-native docker images that are X86_64-based.

docker run --privileged --rm tonistiigi/binfmt --install all

This will reset on the next machine reboot. Therefore, a simple solution to enable it on each reboot is to configure a cron job.

sudo crontab -e

Add the entry at the end of the crontab file:

@reboot docker run --privileged --rm tonistiigi/binfmt --install all

Alternatively, if already on a 64-bit machine and only require running X6_64 (Intel & AMD) architecture, use the following instead to keep it lightweight.

@reboot sudo docker run --rm --privileged aptman/qus -s -- -p x86_64

Save the file. Now the emulation layer will be loaded on system startup. Reboot the instance for the changes to apply.