Dokploy / Dokploy/dokploy

Regression: Ubuntu 26.04 installer still requests Docker 28.5.0 in v0.30.6

Open
#5,471 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

needs-triage🔍
Dominant language
TypeScript
Stars
37.4k
Forks
3k
Avg merge
1d 3h
Merged PRs (30d)
73

Description

To Reproduce
  1. Provision a fresh Ubuntu 26.04 LTS (Resolute Raccoon) amd64 server.
  2. Log in as root.
  3. Run the official Dokploy installation command:
curl -sSL https://dokploy.com/install.sh | sh
  1. The installer detects Dokploy v0.30.6.
  2. During Docker installation, the installer attempts to find Docker CE 28.5.0:
INFO: Searching repository for VERSION '28.5.0'
INFO: apt-cache madison docker-ce | grep '28.5.0' | head -1 | awk '{$1=$1};1' | cut -d' ' -f 3

ERROR: '28.5.0' not found amongst apt-cache madison results
  1. The installer continues despite Docker installation failing and eventually attempts to initialize Docker Swarm:
Using advertise address: <SERVER_IP>
sh: 247: docker: not found
Error: Failed to initialize Docker Swarm
  1. Verify that Docker 28.5.0 is not available in the configured Docker repository:
apt-get update
apt-cache madison docker-ce

The repository contains Docker 29.x versions for Ubuntu 26.04, for example:

docker-ce | 5:29.8.1-1~ubuntu.26.04~resolute
docker-ce | 5:29.8.0-1~ubuntu.26.04~resolute
docker-ce | 5:29.7.2-1~ubuntu.26.04~resolute
...
docker-ce | 5:29.3.1-1~ubuntu.26.04~resolute

but does not contain 28.5.0.

  1. Remove the package holds left by the failed installation attempt:
apt-mark unhold docker-ce docker-ce-cli
  1. Install Docker manually from the same official Docker repository:
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Docker installs successfully, confirming that the Docker repository and Ubuntu 26.04 environment are functional.

  2. Initialize Swarm manually:

docker swarm init --advertise-addr <SERVER_IP>

This also succeeds.

Current vs. Expected behavior

Current behavior:

The v0.30.6 installer attempts to install Docker CE 28.5.0 on Ubuntu 26.04.

Docker 28.5.0 is not available in the official Docker repository for Ubuntu 26.04, which causes the Docker installation to fail.

The installer nevertheless continues and eventually fails with:

docker: not found
Error: Failed to initialize Docker Swarm

This is particularly unexpected because Ubuntu 26.04 has available Docker CE 29.x packages in the official Docker repository.

Expected behavior:

The installer should detect Ubuntu 26.04 and install a Docker version compatible with that release.

Alternatively, if Ubuntu 26.04 is not supported, the installer should detect the unsupported environment and stop with a clear error before making partial changes.

The installer should also stop immediately if the Docker installation fails instead of continuing to Docker Swarm initialization.

Provide environment information
* **Dokploy version:** `v0.30.6`
* **OS:** Ubuntu 26.04 LTS (Resolute Raccoon)
* **Architecture:** amd64
* **Installation method:** Official `https://dokploy.com/install.sh`
* **Docker repository:** `https://download.docker.com/linux/ubuntu resolute/stable`
* **Server:** Fresh VPS
* **Docker initially installed:** No

OS information:


PRETTY_NAME="Ubuntu 26.04 LTS"
NAME="Ubuntu"
VERSION_ID="26.04"
VERSION="26.04 (Resolute Raccoon)"
VERSION_CODENAME=resolute
UBUNTU_CODENAME=resolute
Which area(s) are affected? (Select all that apply)

Installation

Are you deploying the applications where Dokploy is installed or on a remote server?

Same server where Dokploy is installed

Additional context

This appears to be related to the previously reported Ubuntu 26.04 installation problem in #4501 and the fix implemented in #4660.

The v0.30.3 release notes state that Ubuntu 26.04 setup was fixed by installing Docker 29.4.2:

fix(setup): install Docker 29.4.2 on Ubuntu 26.04 to fix failed setup

However, the current v0.30.6 installation path still requests Docker 28.5.0.

This suggests that the fix from #4660 may not be present in the installer currently served by https://dokploy.com/install.sh, may have been subsequently reverted, or there may be a mismatch between the released Dokploy setup code and the published installation script.

The Docker repository itself is working correctly. Docker 29.x can be installed manually on the same server, and Docker Swarm can be initialized successfully.

The relevant failure therefore appears to be specifically within the Dokploy installation path.

For reference, the failure begins with:

INFO: Searching repository for VERSION '28.5.0'
ERROR: '28.5.0' not found amongst apt-cache madison results

and ultimately results in:

docker: not found
Error: Failed to initialize Docker Swarm

It would be useful to verify whether the Docker version selection logic from #4660 is still present in the installer used by v0.30.6.

Will you send a PR to fix it?

Maybe, need help

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the official install.sh entry point and inspect its Docker version selection and failure handling, comparing the current path with the Ubuntu 26.04 fix described in #4660. Done means a fresh Ubuntu 26.04 installation uses an available Docker version and stops clearly if Docker installation fails, rather than continuing to Swarm initialization.

Written by the indexing model from the issue text.

Assessment

Tech stack
bash, docker, linux, ubuntu
Domain
devops, infrastructure
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.