01 / Prepare o servidor.
Escolha seu sistema operacional e a versão para instalar Docker Engine e o plugin Compose. Obtenha o código atual do Sprutio com o responsável pelo projeto e abra o diretório raiz. Docker Desktop não dá acesso às contas de sistema do macOS ou Windows.
Escolha seu sistema operacional
Escolha seu sistema operacional e depois a versão para ver os comandos de instalação.
Ubuntu
amd64 / arm64Escolha uma versão
Ubuntu 26.10 · Stonking
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerUbuntu 26.04 LTS · Resolute
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerUbuntu 24.04 LTS · Noble
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerUbuntu 22.04 LTS · Jammy
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerCentOS
amd64 / arm64Escolha uma versão
CentOS Stream 10
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerCentOS Stream 9
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerDebian
amd64 / arm64Escolha uma versão
Debian 13 · Trixie
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerDebian 12 · Bookworm
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerRaspberry Pi OS
arm64Use a edição de 64 bits do Raspberry Pi OS. Estes comandos usam o repositório oficial do Docker para Debian arm64; a edição de 32 bits não está contemplada.
Escolha uma versão
Raspberry Pi OS Trixie · arm64
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerRaspberry Pi OS Bookworm · arm64
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerFedora
amd64 / arm64Escolha uma versão
Fedora 44
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerFedora 43
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerRHEL
amd64 / arm64Use um sistema RHEL registrado com acesso aos repositórios de pacotes padrão.
Escolha uma versão
RHEL 10
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerRHEL 9
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do DockerRHEL 8
Execute estes comandos como root em um servidor sem um mecanismo de contêineres instalado. Eles instalam Docker Engine, Buildx e o plugin Docker Compose, iniciam o Docker e verificam as versões instaladas.
(
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
)Se Docker, containerd ou Podman já estiver instalado, siga as instruções oficiais de migração antes de continuar.
Instruções oficiais do Docker02 / Compile e inicie.
Execute os comandos como root no diretório do Sprutio que contém compose.yaml. O aplicativo é compilado a partir do código e iniciado como serviço app.
docker compose build
docker compose up -d03 / Confira o aplicativo.
Veja o estado do serviço e os registros recentes. O endereço padrão é http://SERVER_IP:8080. Limite o acesso a uma rede confiável ou estabeleça uma conexão protegida antes de inserir credenciais.
docker compose ps
docker compose logs --tail=100 app04 / Entre com uma conta Linux.
Use o nome e a senha de uma conta da máquina Linux. A conta deve ter senha e um shell habilitado; contas bloqueadas e senhas vazias são rejeitadas. Entrar como root concede privilégios de root. Os arquivos da máquina são montados em /host e as operações usam as permissões do usuário autenticado.
Proteja o acesso remoto.
O acesso padrão ao aplicativo usa HTTP sem criptografia. Senhas e sessões precisam de um caminho de rede protegido. Use uma rede confiável ou um túnel SSH; para uma implantação pública, configure e verifique HTTPS à frente do aplicativo. O HTTPS deste site não configura o HTTPS do seu gerenciador de arquivos.
Preserve as configurações entre reinicializações.
O volume app_data guarda preferências e conexões. Faça backup dele junto com a configuração; os arquivos da máquina precisam de um backup próprio. Os comandos abaixo param e iniciam o serviço. Para atualizar, obtenha uma revisão de código verificada, compile e inicie novamente. Remova o volume de dados apenas se quiser apagar seu conteúdo.
docker compose stop
docker compose start
