Comó Instalar Bitwarden en Docker

Bitwarden es un administrador de contraseñas gratuito y de código abierto que almacena información confidencial en una bóveda cifrada. Está desarrollado en C# utilizando .NET Core y ASP.NET Core, y su base de datos se basa en T-SQL/SQL Server.

Bitwarden es un servicio en la nube accesible mediante diversas aplicaciones cliente, lo que lo hace multiplataforma: a través de la web, aplicaciones de escritorio (Windows, macOS, Linux), móviles, extensiones de navegador (Chrome, Firefox, Safari, Edge, Opera, Vivaldi, Brave, Tor) o por línea de comandos (CLI).

Una de las principales razones para usar Bitwarden es evitar los gestores de contraseñas de terceros, donde los datos se almacenan en servidores externos. En su lugar, puedes desplegar Bitwarden en tu propio servidor seguro.

Bitwarden está compuesto por un conjunto de contenedores, cada uno con un componente funcional separado —como la base de datos o el servidor web. Por tanto, para instalar y ejecutar Bitwarden se necesita un sistema de contenedorización, concretamente Docker.

Principales características de Bitwarden

Copiar enlace

• Código abierto

• Basado en el estándar de cifrado AES de 256 bits

• Soporte para autenticación de dos factores (2FA)

• Sistema de auditoría y verificación de contraseñas

• Soporte para autenticación biométrica

• Posibilidad de hospedar el servidor localmente

• Aplicaciones cliente multiplataforma

Requisitos previos

Copiar enlace

Esta guía utiliza comandos para sistemas operativos tipo UNIX, específicamente Debian/Ubuntu, que se usan con frecuencia para el despliegue de aplicaciones de servidor.

Antes de instalar y configurar Bitwarden, asegúrate de que todos los paquetes del sistema estén actualizados:

sudo apt update

sudo apt upgrade

Si el servidor es nuevo, se recomienda instalar algunas herramientas básicas:

sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

A continuación, asegúrate de tener instalados Docker y Docker Compose para gestionar los contenedores de Bitwarden.

Paso 1: Instalar Docker y sus componentes

Copiar enlace

Primero, añade la clave GPG de Docker, que se utiliza para firmar los paquetes:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

Luego añade el repositorio oficial de Docker para obtener la versión más reciente:

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Actualiza nuevamente el sistema:

sudo apt update

Por último, instala Docker y Docker Compose:

sudo apt install docker-ce docker-ce-cli containerd.io docker-compose

Paso 2: Asegurar la instalación de Bitwarden

Copiar enlace

Para aumentar la seguridad, crea un usuario dedicado con permisos limitados.

Crea un directorio para Bitwarden:

sudo mkdir /opt/bitwarden

Crea el usuario:

sudo adduser bitwarden

Asigna los permisos adecuados al directorio:

sudo chmod -R 700 /opt/bitwarden

sudo chown -R bitwarden:bitwarden /opt/bitwarden

Permite que el usuario Bitwarden ejecute comandos de Docker:

sudo usermod -aG docker bitwarden

Cambia al usuario Bitwarden y entra al directorio de instalación:

su bitwarden

cd /opt/bitwarden

Paso 3: Instalar Bitwarden en Docker y arrancar el servidor

Copiar enlace

Incluso si no tienes experiencia con Docker, los desarrolladores de Bitwarden ofrecen un script de instalación automatizado.

Descárgalo y dale permisos de ejecución:

curl -Lso bitwarden.sh https://go.btwrdn.co/bw-sh && chmod 700 bitwarden.sh

Ejecuta el script:

./bitwarden.sh install

Durante el proceso, se te pedirá información como:

• El dominio de tu instalación de Bitwarden

• El nombre de la base de datos

• Si deseas usar Let’s Encrypt para obtener un certificado SSL gratuito

También deberás introducir un ID de instalación y una clave, que puedes generar en la web oficial de Bitwarden.

Paso 4: Configurar el servidor de correo SMTP

Copiar enlace

Aunque es opcional, se recomienda configurar un servidor SMTP para que el administrador pueda recibir correos de inicio de sesión y notificaciones. Edita el archivo ./bwdata/env/global.override.env y añade los parámetros SMTP, por ejemplo:

globalSettings__mail__smtp__host=smtp.gmail.com

globalSettings__mail__smtp__port=587

globalSettings__mail__smtp__ssl=true

globalSettings__mail__smtp__username=your_email@gmail.com

globalSettings__mail__smtp__password=your_password

adminSettings__admins=your_email@gmail.com

Si ya conoces Docker, puedes usar un servidor de correo en contenedor, como docker-mailserver, ideal para esta tarea.

En escenarios más simples (aunque menos seguros), puedes usar un servidor público como Gmail:

globalSettings__mail__replyToEmail=your_email@gmail.com

globalSettings__mail__smtp__host=smtp.gmail.com

globalSettings__mail__smtp__username=your_email

globalSettings__mail__smtp__password=your_password

globalSettings__mail__smtp__ssl=true

globalSettings__mail__smtp__port=587

globalSettings__mail__smtp__useDefaultCredentials=false

globalSettings__disableUserRegistration=true

Después de configurarlo, Bitwarden enviará notificaciones desde tu cuenta de Gmail. Asegúrate de habilitar la opción “permitir aplicaciones menos seguras” en tu cuenta, o Google bloqueará la conexión.

Si utilizas otro proveedor de correo, consulta su configuración SMTP (host, puerto, SSL) y añade los valores equivalentes en global.override.env.

Si los correos no se envían correctamente, usa una herramienta de prueba SMTP en línea para ajustar los parámetros.

Paso 5: Iniciar el servidor y verificar el funcionamiento

Copiar enlace

Inicia el servidor con el mismo script:

./bitwarden.sh start

Accede desde el navegador utilizando la dirección IP o el dominio configurado.
Para acceder al panel de administración, añade /admin al final de la URL.

La página te pedirá la dirección de correo electrónico configurada en global.override.env.
El servidor SMTP te enviará un enlace para acceder sin contraseña al panel administrativo.

Desde allí, podrás usar las aplicaciones cliente de Bitwarden (de escritorio, web o móvil) conectadas a tu propio servidor.

Detener y eliminar el servidor

Copiar enlace

Si se acumulan errores o deseas reinstalar Bitwarden, detén el servicio completamente:

./bitwarden.sh stop

Elimina el directorio de datos:

rm -r ~/bwdata

Y reinstala si es necesario:

./bitwarden.sh install

Conclusión

Copiar enlace

La instalación de Bitwarden es sencilla gracias al script automatizado que proporcionan sus desarrolladores. Una vez configurado, podrás proteger tus datos sensibles con este potente gestor de contraseñas, integrando DNS, SSL y SMTP según tus necesidades. Consulta la documentación oficial de Bitwarden para obtener más consejos y mejores prácticas de uso.