Skip to content

Automatic installation

SingleJump can be installed with a single command on most modern Linux distributions.
This page explains the automatic installation process, prerequisites, and how to re-run it for updates.

Hardware & Network requirements

To run SingleJump, you need:

  • 2 CPUs
  • 4GB RAM
  • 60GB disk space

Additional recommendations:

  • A static public IP (recommended) so this IP can be added to the firewall of the devices you will manage.
  • If you plan to generate Let’s Encrypt SSL certificates, ensure TCP port 80 is open.

Requirements

Before running the installer, make sure your system meets the following:

1. Linux distribution

A modern Linux distribution such as:

  • Ubuntu / Debian
  • CentOS / Rocky / AlmaLinux
  • openSUSE / SLES
  • Arch / Manjaro

2. Root access

Required for:

  • Creating system directories
  • Running Docker
  • Writing configuration files

Become root:

sudo -i

Or prefix commands with:

sudo

3. Internet connectivity

Required to download:

  • The installation script:
  • https://singlejump.com/install_singlejump.sh
  • Docker images from:
  • docker.singlejump.com

4. curl installed (required)

The installer is downloaded using curl.

Install:

Debian/Ubuntu 

sudo apt install -y curl

CentOS/Rocky/AlmaLinux 

sudo yum install -y curl

Fedora 

sudo dnf install -y curl

openSUSE 

sudo zypper install -y curl

Arch/Manjaro 

sudo pacman -Sy --noconfirm curl

5. Docker and Docker Compose (required)

Check if Docker is installed

docker info

If you see system information: ✔ Docker is installed.

If you get:

command not found: docker

You must install it:

🔗 Official Docker installation guide
https://docs.docker.com/engine/install/

Start and enable Docker

After installation:

sudo systemctl enable --now docker

Verify again:

docker info

Install Docker Compose

SingleJump supports:

Check:

docker compose version

If missing, install from:

🔗 https://docs.docker.com/compose/install/

✔ Legacy docker-compose (fallback)

Check:

docker-compose --version

Install:

Debian/Ubuntu 

sudo apt install -y docker-compose

CentOS/Alma/Rocky 

sudo yum install -y docker-compose

openSUSE 

sudo zypper install -y docker-compose

Arch 

sudo pacman -Sy --noconfirm docker-compose

Verify both

docker info
docker compose version   # or docker-compose --version

If both work, you may proceed.

6. Your SingleJump license credentials

You will need:

  • DOMAIN — your license domain / customer identifier
  • LICENSE_SECRET — your license secret token

The installer will ask for them only the first time.

Recommendation:
Use a subdomain to access your SingleJump instance, e.g.:

login.yourdomain.com

Point it to your server using an A record.

One-line automatic installation

Once Docker, Docker Compose, and curl are installed, run:

curl -fsSL https://singlejump.com/install_singlejump.sh | sudo bash

If already root:

curl -fsSL https://singlejump.com/install_singlejump.sh | bash

What the installer does

  1. Root check
  2. Package manager detection
  3. Checks that Docker & Docker Compose are installed
  4. Creates /opt/singlejump
  5. Loads or creates .env
  6. Creates persistent volume directories
  7. Creates docker-compose.yml (first install only)
  8. Logs into the SingleJump Docker registry
  9. Pulls SingleJump images

Re-running the installer

Run again to update:

curl -fsSL https://singlejump.com/install_singlejump.sh | sudo bash
  • Existing .env is reused
  • Existing docker-compose.yml is not overwritten
  • Latest images are downloaded

🚀 Get Started

Launch your SingleJump:

  • Database initialization
  • Requirements for SSL and Let’s Encrypt
  • Preparing your environment and users

Go to Get Started.