Metoda 1: Instalarea Dokku cu scriptul oficial de bootstrap
Instalati instrumentele mici necesare pentru a rezolva cel mai recent tag de release si a descarca scriptul prin HTTPS:

sudo apt install ca-certificates curl jq

Rezolvati cel mai recent release stabil Dokku de pe GitHub Releases, apoi descarcati scriptul de bootstrap corespunzator. Mentineti aceeasi sesiune de terminal deschisa deoarece comanda de instalare reutilizeaza DOKKU_VERSION:

DOKKU_VERSION="$(curl -fsSL https://api.github.com/repos/dokku/dokku/releases/latest | jq -r '.tag_name')"

case "$DOKKU_VERSION" in
  v[0-9]*)
    curl -fsSLo bootstrap.sh "https://dokku.com/install/${DOKKU_VERSION}/bootstrap.sh"
    ;;
  *)
    printf 'Could not resolve the latest Dokku release tag.\n' >&2
    false
    ;;
esac

Daca Docker este deja instalat, confirmati plugin-urile Buildx si Compose inainte de a rula scriptul de bootstrap. Instalatorul Dokku bootstrappeaza Docker cand comanda docker lipseste, dar o instalare partiala mai veche poate lasa in continuare pachete de plugin-uri necesare nerezolvate:

if command -v docker >/dev/null 2>&1; then
  docker --version
  docker buildx version
  docker compose version
fi

Inspectati scriptul inainte de a-l rula ca root:

Rulati instalatorul bootstrap cu acelasi tag Dokku. Scriptul instaleaza Docker cand comanda docker lipseste, adauga sursa packagecloud Dokku, instaleaza pachetul dokku si ruleaza configurarea dependentelor de plugin core:

Metoda 2: Instalarea Dokku cu o sursa APT manuala DEB822
Folositi metoda manuala cand Docker Engine, Buildx si Compose sunt deja instalate din pachetele oficiale Debian Docker sau un alt set de pachete compatibil. Pe Debian 12 si Debian 11, o sursa packagecloud exclusiv Dokku nu furnizeaza un candidat Buildx, deci verificati Docker mai intai sau instalati Docker pe Debian inainte de a continua:

docker buildx version
docker compose version

Daca vreo comanda lipseste, instalati setul oficial de pachete Docker cu Install Docker on Debian, apoi reveniti la configurarea sursei Dokku.

Instalati pachetele helper pentru download-uri HTTPS si inspectarea cheilor:

sudo apt install ca-certificates curl gpg

Descarcati cheia de semnare packagecloud a Dokku, inspectati amprenta, apoi instalati cheia ca keyring APT cu scope:

gpg --quiet --show-keys --with-fingerprint dokku.asc
sudo install -m 0644 dokku.asc /usr/share/keyrings/dokku-archive-keyring.asc
rm -f dokku.asc

Cheia curenta identifica repository-ul packagecloud Dokku si foloseste aceasta amprenta:

      0027 A6FC E4DE B304 104D  2D13 F1FF 6851 288B 3315
uid                      https://packagecloud.io/dokku/dokku (https://packagecloud.io/docs#gpg_signing) <support@packagecloud.io>

Adaugati sursa APT a Dokku in format DEB822. Comanda scrie sursa doar pentru combinatiile de versiune si arhitectura Debian suportate:

. /etc/os-release
codename="${VERSION_CODENAME:-}"
arch="$(dpkg --print-architecture)"

case "${codename}:${arch}" in
    trixie:amd64|trixie:arm64|bookworm:amd64|bookworm:arm64|bullseye:amd64|bullseye:arm64)
        printf '%s\n' \
        'Types: deb' \
        'URIs: https://packagecloud.io/dokku/dokku/debian/' \
        "Suites: ${codename}" \
        'Components: main' \
        "Architectures: ${arch}" \
        'Signed-By: /usr/share/keyrings/dokku-archive-keyring.asc' \
        | sudo tee /etc/apt/sources.list.d/dokku.sources > /dev/null
        ;;
    *)
        printf 'Dokku packages in this workflow are documented for Debian 13, 12, or 11 on amd64 or arm64. Detected %s on %s.\n' "$codename" "$arch" >&2
        ;;
esac

Opriti-va daca apare mesajul de versiune nesuportata. Altfel, reimprospatati metadatele APT si confirmati ca dokku provine din sursa packagecloud pentru codename-ul Debian vostru:

apt-cache policy dokku

Un candidat valid arata URL-ul packagecloud Dokku, codename-ul Debian si componenta main:

  Installed: (none)
  Candidate: 0.38.5
  Version table:
     0.38.5 500
        500 https://packagecloud.io/dokku/dokku/debian trixie/main amd64 Packages

Pentru build-uri nesupraveghete, preseedati valorile debconf inainte de a instala Dokku. Inlocuiti hostname-ul cu domeniul sau baza wildcard pe care planificati sa o folositi:

dokku dokku/vhost_enable boolean true
dokku dokku/hostname string apps.example.com
dokku dokku/nginx_enable boolean true
EOF

Instalati Dokku, apoi rulati instalatorul de dependente de plugin core:

sudo dokku plugin:install-dependencies --core

Verificarea Dokku pe Debian
Verificati comanda Dokku instalata, plugin-urile core, accesul Docker si serviciul Nginx:

dokku plugin:list
docker --version
docker compose version
sudo systemctl is-active nginx

Daca Nginx este inactiv, verificati statusul sau inainte de a deploya aplicatii:

Configurarea Dokku dupa instalare
O instalare Dokku noua mai necesita o cheie SSH de deploy, un plan de domeniu global sau per-aplicatie si cai de retea deschise pentru serviciile pe care doriti sa le expuneti.

Adaugarea unei chei SSH de deploy in Dokku
Dokku primeste push-uri Git prin utilizatorul SSH dokku. Adaugati o cheie publica pentru contul de administrator care va deploya aplicatii. Numele admin este conventional si acorda acelei chei permisiunea de a gestiona alte chei Dokku:

Listati cheile configurate dupa adaugarea uneia:

Setarea domeniului global Dokku
Setati domeniul global cand majoritatea aplicatiilor trebuie sa foloseasca subdomenii sub aceeasi baza:

Pentru un domeniu de laborator temporar bazat pe IP, inlocuiti adresa de exemplu cu IP-ul public al serverului:

Verificati configuratia curenta a domeniului global:

Deschiderea porturilor web prin UFW cand este activat

Daca statusul raporteaza active:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw status numbered

Deployarea primei aplicatii Dokku pe Debian

Crearea aplicatiei pe hostul Dokku

dokku domains:set sample-app sample-app.apps.example.com
dokku apps:list

Push-ul codului catre Dokku cu Git

git push dokku main:master

Verificarea statusului si jurnalelor

dokku logs sample-app --tail

Gestionarea Dokku pe Debian
Dokku este un framework de comenzi, nu un daemon cu rulare lunga. Docker si Nginx furnizeaza principalele servicii runtime, in timp ce comenzile Dokku gestioneaza aplicatiile, domeniile, plugin-urile si configuratia de deployment.

Actualizarea Dokku pe Debian

Dokku instalat din scriptul bootstrap sau sursa APT manuala se actualizeaza prin APT. Cititi notele oficiale de upgrade Dokku inainte de upgrade-uri majore, mai ales cand actualizarea schimba si Docker, Herokuish sau comportamentul buildpack.

Pentru o reimprospatare normala a pachetelor:

sudo apt-get --no-install-recommends install dokku herokuish sshcommand plugn gliderlabs-sigil dokku-update dokku-event-listener

Cand Docker sau Herokuish se schimba in aceeasi fereastra de mentenanta, opriti mai intai aplicatiile si recompilati dupa upgrade:

Eliminarea Dokku din Debian
Faceti backup la aplicatii, baze de date, volume, variabile de mediu si fisiere incarcate inainte de a elimina Dokku.

Oprirea aplicatiilor si curatarea containerelor Dokku

dokku cleanup

Purificarea pachetelor Dokku

sudo apt-get autoremove

Confirmati ca inregistrarile de pachete au disparut:

Eliminarea fisierelor de sursa APT Dokku

sudo rm -f /etc/apt/sources.list.d/dokku.sources
sudo rm -f /etc/apt/trusted.gpg.d/dokku.asc
sudo rm -f /usr/share/keyrings/dokku-archive-keyring.asc
sudo apt update

Verificati ca niciun fisier sursa Dokku nu ramane:

apt-cache policy dokku

Stergerea datelor Dokku doar cand sunteti gata

ATENTIE: Comanda de eliminare a datelor sterge permanent starea aplicatiilor Dokku, jurnalele si directorul home al utilizatorului Dokku. Nu exporta in siguranta bazele de date ale aplicatiilor, stocarea de obiecte, montarile bind sau volumele Docker. Inspectati mai intai caile candidate:

sudo rm -rf /home/dokku /var/lib/dokku /var/log/dokku

NOTA: Eliminati Docker separat doar cand serverul nu mai ruleaza niciun workload Docker.

Depanare probleme Dokku pe Debian
Scriptul de bootstrap raporteaza o distributie Linux nesuportata
Scriptul de bootstrap verifica /etc/os-release si suporta Debian 11, 12 si 13. Confirmati identitatea hostului si evitati rularea scriptului din containere sau derivative care raporteaza un ID de versiune diferit:

APT nu poate instala dependentele Dokku
Erorile de dependente inseamna de obicei ca sursele de pachete activate nu furnizeaza un set complet Docker, Buildx si Compose pentru lantul de dependente Dokku. Verificati candidatul Dokku si alternativele pachetelor Docker:

NOTA: Pe Debian 13, pachetele docker-buildx si docker-compose ale Debian pot satisface alternativele. Pe Debian 12 si Debian 11, un candidat Buildx lipsa inseamna de obicei ca repository-ul oficial Debian Docker nu a fost adaugat; adaugati Docker, apoi reexecutati sudo apt update si sudo apt install dokku.

Push-urile SSH esueaza cu Permission Denied

sudo dokku ssh-keys:add admin < ~/.ssh/id_rsa.pub

Testati ruta SSH de pe masina de deployment:

Domeniul aplicatiei nu se rezolva sau nu se incarca
Esuarile de domeniu se afla de obicei in DNS, configuratia domeniului Dokku, rutarea Nginx sau firewall-ul hostului:

sudo systemctl is-active nginx
sudo ss -tulpn | grep -E ':(80|443)\b'

Daca raportul domeniului este corect si Nginx este activ, confirmati ca DNS pointeaza catre server si ca firewall-ul permite porturile 80/tcp si 443/tcp.