01 / Підготуйте сервер.
Виберіть операційну систему та її версію, щоб установити Docker Engine і плагін Compose. Отримайте актуальний вихідний код Sprutio від супроводжувача проєкту й відкрийте його кореневий каталог. Docker Desktop не надає доступу до системних користувачів macOS або Windows.
Виберіть операційну систему
Виберіть операційну систему, а потім її версію, щоб побачити команди встановлення.
Ubuntu
amd64 / arm64Виберіть версію
Ubuntu 26.10 · Stonking
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '26.10' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: stonking
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerUbuntu 26.04 LTS · Resolute
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '26.04' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: resolute
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerUbuntu 24.04 LTS · Noble
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '24.04' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: noble
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerUbuntu 22.04 LTS · Jammy
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '22.04' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: jammy
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerCentOS
amd64 / arm64Виберіть версію
CentOS Stream 10
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'centos' ] && [ "${sprutio_os_version%%.*}" = '10' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerCentOS Stream 9
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'centos' ] && [ "${sprutio_os_version%%.*}" = '9' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerDebian
amd64 / arm64Виберіть версію
Debian 13 · Trixie
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '13' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: trixie
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerDebian 12 · Bookworm
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '12' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
amd64|arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: bookworm
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerRaspberry Pi OS
arm64Використовуйте 64-бітну редакцію Raspberry Pi OS. Ці команди використовують офіційний репозиторій Docker для Debian arm64; інструкцій для 32-бітної редакції тут не наведено.
Виберіть версію
Raspberry Pi OS Trixie · arm64
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '13' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: trixie
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerRaspberry Pi OS Bookworm · arm64
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '12' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(dpkg --print-architecture)" in
arm64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: bookworm
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerFedora
amd64 / arm64Виберіть версію
Fedora 44
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'fedora' ] && [ "$sprutio_os_version" = '44' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf5-plugins
dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerFedora 43
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'fedora' ] && [ "$sprutio_os_version" = '43' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf5-plugins
dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerRHEL
amd64 / arm64Використовуйте зареєстровану систему RHEL із доступом до стандартних репозиторіїв пакунків.
Виберіть версію
RHEL 10
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'rhel' ] && [ "${sprutio_os_version%%.*}" = '10' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerRHEL 9
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'rhel' ] && [ "${sprutio_os_version%%.*}" = '9' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції DockerRHEL 8
Виконайте ці команди від імені root на сервері без установленого контейнерного рушія. Вони встановлять Docker Engine, Buildx і плагін Docker Compose, запустять Docker та перевірять установлені версії.
(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'rhel' ] && [ "${sprutio_os_version%%.*}" = '8' ] || {
printf '%s\n' 'OS/version does not match the selected instructions.' >&2
exit 1
}
case "$(uname -m)" in
x86_64|aarch64) ;;
*) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac
dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
docker version
docker compose version
)Якщо Docker, containerd або Podman уже встановлено, перед продовженням дотримуйтеся офіційних інструкцій із переходу.
Офіційні інструкції Docker02 / Зберіть і запустіть.
Виконайте команди від root із каталогу Sprutio, де розташований compose.yaml. Застосунок буде зібрано з вихідного коду й запущено як сервіс app.
docker compose build
docker compose up -d03 / Перевірте застосунок.
Перегляньте стан сервісу й останні записи журналу. Типова адреса — http://SERVER_IP:8080. До введення пароля обмежте доступ довіреною мережею або організуйте захищене з’єднання.
docker compose ps
docker compose logs --tail=100 app04 / Увійдіть під користувачем Linux.
Використовуйте ім’я та пароль облікового запису Linux-хоста. Користувач повинен мати пароль і дозволену оболонку; заблоковані записи та порожні паролі не допускаються. Вхід під root надає права root. Файли хоста підключаються до /host, операції виконуються з правами авторизованого користувача.
Організуйте захищений віддалений доступ.
Типово застосунок працює через звичайний HTTP. Паролям і сеансам потрібен захищений мережевий канал. Використовуйте довірену мережу або SSH-тунель; для публічного доступу налаштуйте та перевірте HTTPS перед застосунком. HTTPS цього сайту не налаштовує HTTPS вашого файлового менеджера.
Зберігайте налаштування між запусками.
Том app_data містить налаштування та збережені з’єднання користувачів. Резервуйте його разом із конфігурацією; файлам хоста потрібна окрема копія. Команди нижче зупиняють і запускають сервіс. Для оновлення отримайте перевірену ревізію коду, зберіть і запустіть знову. Видаляйте том даних лише для навмисного скидання.
docker compose stop
docker compose start
