Como instalar Docker no Ubuntu 22.04
Ambiente Docker
27.01.2026
Reading time: 8 min
Share
Docker é uma ferramenta gratuita e de código aberto para a conteinerização de aplicações. Os contêineres são ambientes isolados semelhantes às máquinas virtuais (VMs), porém mais leves e portáveis entre plataformas, exigindo menos recursos do sistema. O Docker utiliza virtualização em nível de sistema operacional, aproveitando recursos integrados ao kernel do Linux.
Ordem dos aplicativos após a instalação do Docker no Ubuntu
Embora este procedimento também seja aplicável a outras versões do Ubuntu, este tutorial explica como instalar o Docker no Ubuntu 22.04. Também faremos o download do Docker Compose, uma ferramenta necessária para gerenciar vários contêineres de forma eficaz.
Para este guia, utilizaremos um servidor em nuvem da Hostman.
Escolha seu servidor agora
Requisitos do sistema
De acordo com a documentação do Docker, as seguintes versões de 64 bits do Ubuntu são compatíveis:
-
Ubuntu Oracular 24.10
-
Ubuntu Noble 24.04 (LTS)
-
Ubuntu Jammy 22.04 (LTS)
-
Ubuntu Focal 20.04 (LTS)
O Docker funciona na maioria das arquiteturas populares. Os requisitos de recursos do seu dispositivo dependerão do uso pretendido e de quão confortavelmente você deseja trabalhar com o Docker. A escala das aplicações que você pretende implantar em contêineres determinará, em grande parte, as necessidades do sistema. Algumas fontes recomendam um mínimo de 2 GB de RAM.
Além disso, é necessária uma conexão estável com a internet.
Instalar Docker no Ubuntu 22.04
A instalação do Docker no Ubuntu 22.04 envolve a execução de uma série de comandos no terminal. A seguir, apresentamos um guia passo a passo com explicações. Os passos também se aplicam às versões de servidor do Ubuntu.
1. Atualizar os índices de pacotes
O repositório padrão nem sempre contém as versões mais recentes do software. Portanto, faremos o download do Docker a partir do repositório oficial para garantir a versão mais atual. Primeiro, atualize os índices de pacotes:
sudo apt update2. Instalar pacotes adicionais
Para instalar o Docker, você precisará baixar quatro pacotes adicionais:
curl: Necessário para interagir com recursos da web.software-properties-common: Permite o gerenciamento de software por meio de scripts.ca-certificates: Contém informações sobre autoridades certificadoras.apt-transport-https: Necessário para a transferência de dados por meio do protocolo HTTPS.
Baixe esses pacotes com o seguinte comando:
sudo apt install curl software-properties-common ca-certificates apt-transport-https -yA opção -y responde automaticamente "Sim" a todas as solicitações do terminal.
3. Importar a chave GPG
As assinaturas de software devem ser verificadas usando uma chave GPG. O repositório do Docker deve ser adicionado à lista local. Use o comando abaixo para importar a chave GPG:
wget -O- https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor | sudo tee /etc/apt/keyrings/docker.gpg > /dev/nullDurante o processo de importação, o terminal pode exibir um aviso antes de confirmar a execução bem-sucedida do comando.
4. Adicionar o repositório do Docker
Adicione o repositório para sua versão do Ubuntu com o codinome "Jammy". Para outras versões, utilize os respectivos codinomes listados na seção "Requisitos do sistema". Execute o seguinte comando:
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/nullDurante a execução, o terminal solicitará a confirmação da operação. Pressione Enter.
5. Atualizar novamente os índices de pacotes
Após realizar essas alterações, atualize os índices de pacotes mais uma vez usando o comando habitual:
sudo apt update6. Verificar o repositório
Certifique-se de que a instalação será realizada a partir do repositório correto executando o seguinte comando:
apt-cache policy docker-ceExemplo de saída:
Dependendo das versões mais recentes do Docker, o resultado pode variar. Verificar se a instalação será realizada a partir do repositório oficial do Docker é fundamental.
7. Instalar Docker
Após configurar os repositórios, prossiga com a instalação do Docker:
sudo apt install docker-ce -yO processo de instalação será iniciado imediatamente. Para confirmar que a instalação foi bem-sucedida, verifique o status do Docker no sistema:
sudo systemctl status dockerExemplo de saída:
A saída deve indicar que o serviço do Docker está ativo e em execução.
Se você procura uma solução confiável, de alto desempenho e com bom custo-benefício para seus fluxos de trabalho, a Hostman oferece opções de Linux VPS Hosting, incluindo Debian VPS, Ubuntu VPS e VPS CentOS.
Instalar Docker Compose
Docker Compose é uma ferramenta do Docker projetada para gerenciar vários contêineres. Ela é comumente usada em projetos nos quais muitos contêineres precisam trabalhar juntos como um sistema unificado. Gerenciar esse processo manualmente pode ser desafiador. Em vez disso, você descreve toda a configuração em um único arquivo YAML contendo as configurações e definições de todos os contêineres e de suas aplicações.
Existem várias maneiras de instalar o Docker Compose. Se você precisar da versão mais recente, certifique-se de utilizar a instalação manual ou a instalação por meio do sistema de controle de versão Git.
Instalação via apt-get
Se ter a versão mais recente não for essencial para você, o Docker Compose pode ser instalado diretamente a partir do repositório do Ubuntu. Execute o seguinte comando:
sudo apt-get install docker-composeInstalação via Git
Primeiro, instale o Git:
sudo apt-get install gitVerifique a instalação conferindo a versão do Git:
git --versionA saída deve mostrar a versão do Git.
Em seguida, clone o repositório do Docker Compose. Acesse a página do Docker Compose no GitHub e copie a URL do repositório.
Execute o seguinte comando para clonar o repositório:
git clone https://github.com/docker/compose.gitO processo de clonagem será iniciado, e o repositório será baixado do GitHub.
Instalação manual
Acesse o repositório do Docker Compose no GitHub e localize a versão mais recente sob a tag Latest.
No momento da redação deste guia, a versão mais recente do Docker Compose é a v2.31.0. Vamos fazer o download:
sudo curl -L "https://github.com/docker/compose/releases/download/v2.31.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composeNesse comando, os parâmetros $(uname -s) e $(uname -m) consideram automaticamente as características e a arquitetura do sistema. Após a conclusão do download, altere as permissões do arquivo:
sudo chmod +x /usr/local/bin/docker-compose
Ordem correta da sua infraestrutura após a instalação do Docker no Ubuntu
Conclusão
Neste guia, abordamos a instalação do Docker no Ubuntu 22.04, juntamente com várias maneiras de instalar o Docker Compose. Você pode solicitar um servidor em nuvem da Hostman para seus experimentos e práticas.
Escolha seu servidor agora
Perguntas frequentes (FAQ)
Como instalar o Docker pelo terminal?
A maneira mais fácil de instalar a versão padrão do Ubuntu é executar: sudo apt update sudo apt install docker.io Observação: para obter a versão mais recente, você deve configurar o repositório oficial do Docker e instalar o docker-ce.
Como executar o Docker sem usar sudo?
Por padrão, o Docker requer privilégios de root. Para executá-lo como usuário padrão, adicione seu usuário ao grupo "docker":
-
sudo usermod -aG docker $USER
-
Faça logout e login novamente para que as alterações entrem em vigor.
Como verificar se o Docker está instalado e em execução?
Execute o contêiner "hello-world" para verificar toda a cadeia de ferramentas: sudo docker run hello-world Se for bem-sucedido, uma imagem de teste será baixada e uma mensagem de boas-vindas será exibida.
Como instalar o Docker Compose no Ubuntu 22.04?
Em versões modernas, o Docker Compose é incluído como um plugin. Instale-o via: sudo apt install docker-compose-plugin Você pode então executá-lo usando docker compose (observe o espaço, sem hífen).
Qual é a diferença entre docker.io e docker-ce?
-
docker.io: O pacote Docker mantido pela equipe do Ubuntu. É estável, mas pode ser um pouco mais antigo.
-
docker-ce: O pacote "Community Edition" mantido diretamente pela Docker, Inc. Ele contém os recursos e correções mais recentes.
Como desinstalar o Docker?
Para remover o software, mas manter seus contêineres e imagens: sudo apt remove docker docker.io containerd runc Para remover tudo, incluindo imagens e volumes, exclua o diretório: sudo rm -rf /var/lib/docker.
Ambiente Docker
27.01.2026
Reading time: 8 min
Share
Semelhante
Ambiente Docker
Instalar e usar Docker Compose no Ubuntu: guia completo
O Docker Compose mudou de forma fundamental a maneira como desenvolvedores trabalham com aplicações conteinerizadas, especialmente ao coordenar serviços que dependem uns dos outros. Essa ferramenta substitui o gerenciamento manual de contêineres por um fluxo de trabalho estruturado e orientado por YAML, permitindo que equipes definam arquiteturas completas de aplicações em um único arquivo de configuração.
Em ambientes Ubuntu, isso se traduz em implantações reproduzíveis, escalonamento simplificado e menor sobrecarga operacional. Este guia oferece uma nova perspectiva sobre a instalação e o uso do Docker Compose, fornecendo insights mais profundos sobre sua implementação prática.
Pré-requisitos
Antes de iniciar este tutorial, você precisará ter:
Implantar uma instância de servidor cloud Ubuntu na Hostman.
Garantir que você tenha uma conta de usuário com privilégios sudo ou acesso root, permitindo instalar pacotes e gerenciar o Docker.
Ter o Docker instalado e em execução no servidor, pois o Docker Compose funciona sobre o Docker Engine.
Por que o Docker Compose é importante
Aplicações modernas geralmente envolvem componentes interconectados, como APIs, bancos de dados e camadas de cache. Gerenciar esses elementos individualmente com comandos do Docker torna-se trabalhoso à medida que a complexidade cresce. O Docker Compose resolve isso permitindo declarar todos os serviços, redes e requisitos de armazenamento em um arquivo docker-compose.yml. Essa abordagem garante consistência entre ambientes — seja em uma máquina Ubuntu local ou em um servidor na nuvem.
Por exemplo, considere uma aplicação web composta por um backend Node.js, um banco de dados PostgreSQL e um cache Redis. Sem o Docker Compose, cada componente exigiria comandos docker run separados com configurações de rede precisas. Com o Compose, essas relações são organizadas uma única vez, permitindo iniciar e encerrar tudo com apenas um comando.
Instalação do Docker Compose
Siga estas etapas para instalar o Docker Compose no seu sistema Ubuntu.
Etapa 1: Verificar se o Docker Engine está instalado e em execução
O Docker Compose funciona como uma extensão do Docker, portanto verifique seu status:
sudo systemctl status docker
Se estiver inativo, inicie o serviço com:
sudo systemctl start docker
Etapa 2: Atualizar os pacotes do sistema
Atualize a lista de pacotes para garantir acesso às versões mais recentes do software:
sudo apt-get update
Etapa 3: Instalar utilitários básicos
Para comunicação segura com os repositórios do Docker, são necessários os seguintes pacotes:
sudo apt-get install ca-certificates curl
Etapa 4: Configurar a chave GPG do Docker
Autentique os pacotes do Docker adicionando a chave criptográfica:
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
Esta etapa garante que os pacotes não tenham sido alterados durante a transferência.
Etapa 5: Integrar o repositório do Docker
Adicione o repositório adequado à sua versão do Ubuntu:
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
O comando detecta automaticamente a versão do sistema operacional usando VERSION_CODENAME.
Etapa 6: Instalar o plugin Docker Compose
Atualize os repositórios e instale a extensão do Compose:
sudo apt update
sudo apt-get install docker-compose-plugin
Etapa 7: Validar a instalação
Confirme se a instalação foi bem-sucedida:
docker compose version
Exemplo de saída:
Docker Compose version v2.33.0
Criando um projeto prático com Docker Compose
Vamos implantar um servidor web usando Nginx para demonstrar os recursos do Docker Compose.
1. Inicializar o diretório do projeto
Crie um espaço de trabalho dedicado:
mkdir ~/compose-demo && cd ~/compose-demo
2. Definir serviços em docker-compose.yml
Crie o arquivo de configuração:
nano docker-compose.yml
Insira o seguinte conteúdo:
services:
web:
image: nginx:alpine
ports:
- "8080:80"
volumes:
- ./app:/usr/share/nginx/html
Explicação:
services: Elemento raiz que define os contêineres
web: Nome personalizado do serviço
image: Imagem do Nginx baseada em Alpine, com menor consumo de recursos
ports: Mapeia a porta 8080 do host para a porta 80 do contêiner
volumes: Sincroniza o diretório local app com a raiz web do contêiner
3. Criar o conteúdo web
Construa a estrutura HTML:
mkdir app
nano app/index.html
Adicione o seguinte conteúdo:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Docker Compose Test</title>
</head>
<body>
<h1>Hello from Docker Compose!</h1>
</body>
</html>
Orquestrando contêineres: do início ao encerramento
1. Iniciar os serviços em modo desacoplado
docker compose up -d
O Docker Compose baixará automaticamente a imagem do Nginx, se necessário, e configurará a rede.
2. Verificar o status dos contêineres
docker compose ps -a
3. Acessar a aplicação web
Acesse http://localhost:8080 localmente ou http://<SERVER_IP>:8080 em servidores remotos. A página de teste deverá ser exibida corretamente.
4. Diagnosticar problemas por meio de logs
Se a página não carregar ou ocorrerem erros, inspecione os logs do contêiner:
docker compose logs web
5. Encerramento e limpeza adequados
Parar os contêineres temporariamente:
docker compose stop
Remover todos os recursos do projeto:
docker compose down
Referência de comandos: além do básico
Estes comandos ampliam o gerenciamento de contêineres:
docker compose up --build – Reconstruir imagens antes de iniciar os contêineres
docker compose pause – Pausar contêineres sem encerrá-los
docker compose top – Exibir processos em execução nos contêineres
docker compose config – Validar e exibir a configuração final
docker compose exec – Executar comandos em contêineres ativos(por exemplo, docker compose exec web nginx -t para testar a configuração do Nginx)
Conclusão
O Docker Compose transforma a orquestração de múltiplos contêineres de uma tarefa manual e complexa em um processo estruturado, repetível e eficiente. Seguindo as etapas descritas — instalando o Docker Compose, definindo serviços em YAML e utilizando os comandos essenciais — você pode gerenciar aplicações complexas com segurança e confiança.
15 January 2026 · 6 min to read
Ambiente Docker
Instalar o Nextcloud com Docker
Para quem deseja ter controle total sobre seus dados, o Nextcloud oferece uma poderosa solução open-source para criar um sistema de armazenamento em nuvem privado. A plataforma não só permite sincronização segura de arquivos entre dispositivos, como também possibilita hospedar o armazenamento no seu próprio servidor, evitando a dependência de provedores terceiros.
Neste guia, vamos passar pelo processo de instalação do Nextcloud usando contêineres Docker isolados, o que simplifica bastante o deployment e a administração. Também vamos configurar criptografia automática de tráfego com certificados SSL do Let’s Encrypt para garantir uma transmissão segura dos dados.
Pré-requisitos
Você vai precisar de:
Um servidor em nuvem Hostman com Linux Ubuntu 24.04 pré-instalado.
Um nome de domínio.
Docker e Docker Compose instalados.
Para o servidor, recomenda-se uma configuração com 1 núcleo de CPU, 2 GB de RAM e um endereço IPv4 público, que pode ser solicitado ao criar o servidor ou depois, na seção “Network”.
O servidor estará pronto em poucos minutos. O endereço IPv4 e as credenciais de login para acesso via SSH estarão disponíveis no Dashboard.
Instalar e executar o Nextcloud
O Nextcloud requer vários componentes essenciais:
Banco de dados: neste caso, MariaDB — um SGBD rápido e confiável.
Certificado SSL: usaremos certificados gratuitos emitidos pelo Let’s Encrypt.
Reverse proxy: utilizaremos o Nginx Proxy Manager, que roteará o tráfego HTTP e HTTPS para os contêineres corretos.
Passo 1: Criar o diretório de configuração
Primeiro, crie o diretório onde ficarão os arquivos de configuração e navegue até ele:
mkdir nextcloud && cd nextcloud
Passo 2: Criar o arquivo .env
Este arquivo oculto armazenará variáveis com senhas:
nano .env
Conteúdo do arquivo:
NEXTCLOUD_ROOT_PASSWORD=secure_root_password_123
NEXTCLOUD_DB_PASSWORD=secure_nextcloud_db_password_456
NPM_ROOT_PASSWORD=secure_npm_root_password_789
NPM_DB_PASSWORD=secure_npm_db_password_012
Não esqueça de substituir os valores pelas suas próprias senhas seguras.
Passo 3: Criar o arquivo docker-compose.yml
Crie o arquivo com:
nano docker-compose.yml
Adicione a configuração abaixo (não traduzida conforme solicitado):
volumes:
nextcloud-data:
nextcloud-db:
npm-data:
npm-ssl:
npm-db:
networks:
frontend:
backend:
services:
nextcloud-app:
image: nextcloud:31.0.8
restart: always
volumes:
- nextcloud-data:/var/www/html
environment:
- MYSQL_PASSWORD=${NEXTCLOUD_DB_PASSWORD}
- MYSQL_DATABASE=nextcloud
- MYSQL_USER=nextcloud
- MYSQL_HOST=nextcloud-db
- MYSQL_PORT=3306
networks:
- frontend
- backend
nextcloud-db:
image: mariadb:12.0.2
restart: always
command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW
volumes:
- nextcloud-db:/var/lib/mysql
environment:
- MYSQL_ROOT_PASSWORD=${NEXTCLOUD_ROOT_PASSWORD}
- MYSQL_PASSWORD=${NEXTCLOUD_DB_PASSWORD}
- MYSQL_DATABASE=nextcloud
- MYSQL_USER=nextcloud
networks:
- backend
npm-app:
image: jc21/nginx-proxy-manager:2.12.6
restart: always
ports:
- "80:80"
- "81:81"
- "443:443"
environment:
- DB_MYSQL_HOST=npm-db
- DB_MYSQL_PORT=3306
- DB_MYSQL_USER=npm
- DB_MYSQL_PASSWORD=${NPM_DB_PASSWORD}
- DB_MYSQL_NAME=npm
volumes:
- npm-data:/data
- npm-ssl:/etc/letsencrypt
networks:
- frontend
- backend
npm-db:
image: jc21/mariadb-aria:10.11.5
restart: always
environment:
- MYSQL_ROOT_PASSWORD=${NPM_ROOT_PASSWORD}
- MYSQL_DATABASE=npm
- MYSQL_USER=npm
- MYSQL_PASSWORD=${NPM_DB_PASSWORD}
volumes:
- npm-db:/var/lib/mysql
networks:
- backend
Passo 4: Iniciar os contêineres
Execute:
docker compose up -d
Caso ocorra um erro relacionado ao limite de downloads do Docker Hub:
Entre na sua conta do Docker Hub ou crie uma nova.
Vá até Account settings → Personal access tokens.
Clique em Generate new token.
Defina uma descrição, escolha uma data de expiração e selecione as permissões: Read, Write, Delete.
Clique em Generate e copie o token (ele aparece apenas uma vez).
No servidor, faça login:
docker login -u dockeruser
Substitua dockeruser pelo seu nome de usuário e use o token como senha.
Reinicie os contêineres:
docker compose up -d
Verifique o status:
docker ps
Todos os contêineres devem exibir Up.
Passo 5: Configurar HTTPS com Let’s Encrypt
Abra no navegador:
http://<server-IP>:81
Faça login com as credenciais padrão:
Usuário: admin@example.com
Senha: changeme
No primeiro login:
Atualize o nome, apelido e e-mail do administrador.
Altere a senha:
Current Password: changeme
New Password: nova senha
Confirm Password: repetir senha
Passo 6: Adicionar um Proxy Host
Acesse Hosts → Proxy Hosts.
Clique em Add Proxy Host e preencha:
Domain Names: domínio da sua instância Nextcloud
Scheme: http
Forward Hostname/IP: nextcloud-app
Forward Port: 80
Na aba SSL:
Selecione Request a new SSL Certificate
Ative:
Force SSL
HTTP/2 Support
HSTS Enabled
Informe seu e-mail para o Let’s Encrypt e aceite os termos. Clique em Save.
Passo 7: Fazer login no Nextcloud
Agora abra o seu domínio. Se tudo foi configurado corretamente, a interface web do Nextcloud será exibida e um certificado SSL será emitido automaticamente pelo Let’s Encrypt.
Crie uma nova conta de administrador.
Instale apps recomendadas, se desejar.
A instalação e a configuração básica estão concluídas.
Conclusão
Neste artigo mostramos como fazer o deploy do Nextcloud usando Docker e como emitir um certificado SSL gratuito do Let’s Encrypt.
Esse método é um dos mais confiáveis, seguros e fáceis de escalar. O Docker garante isolamento adequado da aplicação, simplifica atualizações e facilita migrações. Usar um certificado SSL não é apenas recomendado — é essencial para proteger dados sensíveis e garantir tráfego criptografado.
25 November 2025 · 7 min to read
Ambiente Docker
Instalando o Bitwarden no Docker
Bitwarden é um gerenciador de senhas gratuito e de código aberto que armazena informações confidenciais em um cofre criptografado. Ele é desenvolvido em C#, utilizando .NET Core e ASP.NET Core, e sua base de dados é baseada em T-SQL/SQL Server.
O Bitwarden é um serviço em nuvem acessível por meio de diversos aplicativos clientes, tornando-o multiplataforma: na web, em aplicativos desktop (Windows, macOS, Linux), aplicativos móveis, extensões de navegador (Chrome, Firefox, Safari, Edge, Opera, Vivaldi, Brave, Tor) e também via linha de comando (CLI).
Um dos principais motivos para usar o Bitwarden é evitar gerenciadores de senha de terceiros, onde dados sensíveis ficam armazenados em servidores externos. Em vez disso, é possível hospedar o Bitwarden no seu próprio servidor seguro.
O Bitwarden é composto por um conjunto de contêineres, e cada contêiner contém um componente funcional do sistema — como o banco de dados ou o servidor web. Portanto, para instalar e executar o Bitwarden, é necessário um sistema de containerização, neste caso, o Docker.
Principais recursos do Bitwarden
Código aberto (open source)
Criptografia AES de 256 bits para proteger os dados do usuário
Suporte a autenticação de dois fatores (2FA)
Sistema de auditoria e verificação de senhas
Suporte a autenticação biométrica
Possibilidade de hospedar o servidor localmente
Aplicativos clientes multiplataforma em todos os sistemas populares
Pré-requisitos
Este tutorial utiliza comandos para sistemas UNIX-like, em especial Debian/Ubuntu, amplamente usados para deploys de servidores.
Antes de instalar e configurar o Bitwarden, garanta que os pacotes do sistema estejam atualizados:
sudo apt update
sudo apt upgrade
Se o servidor for novo, instale algumas ferramentas básicas:
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
Em seguida, certifique-se de ter Docker e Docker Compose instalados para gerenciar os contêineres do Bitwarden.
Passo 1: Instalar o Docker e seus componentes
Adicione a chave GPG oficial do Docker, usada para assinar pacotes:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
Depois, adicione o repositório do Docker para obter a versão mais recente:
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
Atualize novamente o sistema:
sudo apt update
Por fim, instale o Docker e o Docker Compose:
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose
Passo 2: Proteger a instalação do Bitwarden
Para aumentar a segurança, crie um usuário dedicado com permissões limitadas.
Crie o diretório do Bitwarden:
sudo mkdir /opt/bitwarden
Crie o usuário:
sudo adduser bitwarden
Defina as permissões e o proprietário do diretório:
sudo chmod -R 700 /opt/bitwarden
sudo chown -R bitwarden:bitwarden /opt/bitwarden
Permita que o usuário Bitwarden execute comandos Docker:
sudo usermod -aG docker bitwarden
Em seguida, troque para o usuário Bitwarden:
su bitwarden
cd /opt/bitwarden
Passo 3: Instalar o Bitwarden no Docker e iniciar o servidor
Mesmo que você não tenha experiência com Docker, os desenvolvedores do Bitwarden fornecem um script de instalação automatizado.
Baixe o script e torne-o executável:
curl -Lso bitwarden.sh https://go.btwrdn.co/bw-sh && chmod 700 bitwarden.sh
Execute o script:
./bitwarden.sh install
Durante a instalação, o script pedirá várias informações, como:
O domínio do servidor Bitwarden
O nome do banco de dados
Se deseja usar o Let’s Encrypt para emitir um certificado SSL gratuito
Você também precisará informar um ID de instalação e uma chave, que podem ser gerados no site oficial do Bitwarden.
Passo 4: Configurar o servidor de e-mail SMTP
Embora seja opcional, é recomendável configurar um servidor SMTP para permitir o envio de e-mails administrativos. Edite o arquivo ./bwdata/env/global.override.env e adicione as variáveis de configuração, por exemplo:
globalSettings__mail__smtp__host=smtp.gmail.com
globalSettings__mail__smtp__port=587
globalSettings__mail__smtp__ssl=true
globalSettings__mail__smtp__username=seu_email@gmail.com
globalSettings__mail__smtp__password=sua_senha
adminSettings__admins=seu_email@gmail.com
Se você já domina Docker, pode utilizar um servidor de e-mail em contêiner, como o docker-mailserver, que funciona muito bem com o Bitwarden. Em um cenário mais simples (embora menos seguro), é possível usar um servidor público como o Gmail:
globalSettings__mail__replyToEmail=seu_email@gmail.com
globalSettings__mail__smtp__host=smtp.gmail.com
globalSettings__mail__smtp__username=seu_email
globalSettings__mail__smtp__password=sua_senha
globalSettings__mail__smtp__ssl=true
globalSettings__mail__smtp__port=587
globalSettings__mail__smtp__useDefaultCredentials=false
globalSettings__disableUserRegistration=true
Após configurar, o Bitwarden enviará notificações por meio da sua conta do Gmail. Certifique-se de ativar a opção “permitir aplicativos menos seguros” em sua conta, caso contrário o Google poderá bloquear o envio.
Se estiver usando outro provedor de e-mail, consulte as configurações SMTP (endereço do host, porta, SSL, etc.) e adicione-as de forma equivalente. Se o envio falhar, utilize uma ferramenta de teste SMTP online para validar e ajustar as configurações.
Passo 5: Iniciar o servidor e verificar o funcionamento
Inicie o servidor com o mesmo script:
./bitwarden.sh start
Abra o navegador e acesse o servidor usando o IP ou domínio configurado. Para abrir o painel de administração, adicione /admin ao final da URL.
A página solicitará o endereço de e-mail configurado no arquivo global.override.env. O servidor de e-mail enviará um link para login sem senha, que dá acesso direto ao painel administrativo.
A partir daí, você pode utilizar qualquer cliente Bitwarden — desktop, web ou mobile — para conectar-se ao seu servidor e gerenciar senhas com segurança.
Parar e remover o servidor
Caso surjam problemas ou você deseje reinstalar o Bitwarden, interrompa completamente o serviço:
./bitwarden.sh stop
Remova o diretório de dados:
rm -r ~/bwdata
E reinstale, se necessário:
./bitwarden.sh install
Conclusão
A instalação do Bitwarden é simples, já que o script fornecido pelos desenvolvedores automatiza grande parte do processo. Após configurá-lo, você poderá proteger seus dados sensíveis com este gerenciador de senhas robusto, utilizando DNS, SSL e SMTP conforme necessário. Para mais detalhes e boas práticas, consulte a documentação oficial do Bitwarden.
07 November 2025 · 6 min to read
Tem perguntas,
comentários ou preocupações?
Nossos profissionais estão disponíveis para ajudá-lo a qualquer momento,
seja para assistência ou apenas se você não souber por onde começar.
seja para assistência ou apenas se você não souber por onde começar.
