Servidor Dedicado: Configura Bitwarden en Linux

Esta guía fue creada con los siguientes productos:

(Los detalles pueden variar según los productos de diferentes proveedores, pero los conceptos principales permanecen igual)

Servidor dedicado

Introducción

Bitwarden es un gestor de contraseñas open source para contraseñas y claves que usa cifrado de conocimiento cero y de extremo a extremo para proteger tus datos. Puedes usarlo como servicio en la nube o autoalojarlo, con funciones para generar, almacenar y autocompletar credenciales fuertes.

¿Estás pensando en alojar este servicio tú mismo? Te guiaremos paso a paso sobre cómo configurarlo y ajustarlo, junto con todo lo que debes tener en cuenta.

Requisitos previos

Antes de instalar Bitwarden, asegúrate de que tu entorno de hosting cumple con los siguientes requisitos para garantizar una instalación fluida y un rendimiento óptimo.

Hardware	Mínimo	Recomendación ZAP-Hosting
CPU	1 núcleo de CPU	4 núcleos de CPU
RAM	2 GB	4 GB
Espacio en disco	12 GB	25 GB

El software requiere que todas las dependencias necesarias estén instaladas y que se ejecute en un sistema operativo soportado. Asegúrate de que tu servidor cumple con los siguientes requisitos antes de continuar con la instalación:

Dependencias: Docker (Engine 26+ y Compose)

Sistema operativo: Última versión de Ubuntu/Debian compatible con Docker 26+

Verifica que todas las dependencias estén instaladas y que uses la versión correcta del sistema operativo para evitar problemas de compatibilidad durante la instalación de Bitwarden.

Preparación

Antes de configurar Bitwarden, necesitas preparar tu sistema. Esto incluye actualizar tu sistema operativo a la última versión e instalar todas las dependencias necesarias. Estas preparaciones aseguran un entorno estable y ayudan a prevenir problemas durante o después de la instalación.

Actualizar sistema

Para asegurarte de que tu sistema corre con el software y mejoras de seguridad más recientes, siempre debes hacer primero una actualización del sistema. Para ello, ejecuta el siguiente comando:

sudo apt update && sudo apt upgrade -y

Esto garantiza que tu sistema tenga los últimos parches de seguridad y versiones de software antes de continuar.

Instalar dependencias

Una vez completada la actualización, puedes proceder con la instalación de las dependencias. Bitwarden se desplegará y ejecutará en tu máquina usando varios contenedores Docker. Por eso, primero debes instalar Docker. Ejecuta el siguiente comando:

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

Un tutorial completo del proceso de instalación y cómo usar Docker está disponible en nuestra guía de Docker.

Crear usuario y directorio

Recomendamos configurar tu servidor Linux con una cuenta de servicio dedicada llamada bitwarden, desde la cual instalar y ejecutar Bitwarden. Esto asegura que tu instancia de Bitwarden esté aislada de otras aplicaciones que corran en tu servidor.

Crea el usuario bitwarden y asigna una contraseña fuerte y única para esta cuenta.

sudo adduser bitwarden
sudo passwd bitwarden

Crea el grupo docker si no existe y añade el usuario bitwarden al grupo docker:

sudo groupadd docker
sudo usermod -aG docker bitwarden

Crea el directorio de trabajo, asigna permisos y la propiedad al usuario bitwarden:

sudo mkdir /opt/bitwarden
sudo chmod -R 700 /opt/bitwarden
sudo chown -R bitwarden:bitwarden /opt/bitwarden

Configura tu dominio

Por defecto, Bitwarden corre en el host usando los puertos 80 (HTTP) y 443 (HTTPS). Configura un dominio con registros DNS apuntando al host, por ejemplo server.ejemplo.com, especialmente si lo vas a servir en internet. Evita incluir “bitwarden” en el nombre de host para reducir la exposición del rol o software del servidor.

Instalación

Ahora que todos los requisitos están cumplidos y las preparaciones hechas, puedes proceder con la instalación de la aplicación Bitwarden.

Descarga el script de instalación de Bitwarden a tu máquina y luego ejecuta el instalador. Se creará un directorio ./bwdata relativo a la ubicación de bitwarden.sh.

curl -Lso bitwarden.sh "https://func.bitwarden.com/api/dl/?app=self-host&platform=linux" && chmod 700 bitwarden.sh
./bitwarden.sh install

En el instalador primero introduces el nombre de dominio de tu instancia Bitwarden, normalmente el registro DNS configurado. Luego eliges si Let’s Encrypt debe generar un certificado SSL gratuito y confiable. Si sí, proporcionas un email para avisos de expiración. Si no, siguen las preguntas sobre el certificado.

Introduce tu ID de instalación y clave de instalación, ambos obtenidos en Bitwarden. Luego selecciona la región US o EU, que solo importa si conectas una instancia autoalojada a una suscripción paga.

Si no usas Let’s Encrypt, puedes usar un certificado existente colocando los archivos en ./bwdata/ssl/tu.dominio y declarando si es confiable. Alternativamente, puedes generar un certificado autofirmado, recomendado solo para pruebas. Si eliges no usar certificado, debes colocar un proxy HTTPS delante de la instalación o las aplicaciones Bitwarden no funcionarán.

Configuración

Después de la instalación, completa la configuración básica usando dos archivos. Primero edita el archivo de entorno en ./bwdata/env/global.override.env. Configura ahí los detalles de tu servidor SMTP, incluyendo host, puerto, SSL, usuario y contraseña, para que Bitwarden pueda enviar emails de verificación e invitaciones a organizaciones. Si necesitas acceso al Portal de Administrador del Sistema, añade un email administrador en adminSettings__admins.

...
globalSettings__mail__smtp__host=<placeholder>
globalSettings__mail__smtp__port=<placeholder>
globalSettings__mail__smtp__ssl=<placeholder>
globalSettings__mail__smtp__username=<placeholder>
globalSettings__mail__smtp__password=<placeholder>
...
adminSettings__admins=
...

Valida la configuración SMTP con ./bitwarden.sh checksmtp. Una configuración correcta reporta éxito; si no, verás mensajes sobre OpenSSL faltante o valores incorrectos. Aplica cambios con ./bitwarden.sh restart.

Luego revisa los parámetros de instalación en ./bwdata/config.yml. Este archivo controla los recursos generados y debe ajustarse para entornos especiales, por ejemplo si usas un proxy o puertos alternativos. Aplica estos cambios con ./bitwarden.sh rebuild.

Finalmente, inicia la instancia con ./bitwarden.sh start. La primera ejecución puede tardar mientras Docker descarga las imágenes. Usa docker ps para confirmar que todos los contenedores están saludables. Luego abre la bóveda web en tu dominio configurado y registra una cuenta si es necesario. La verificación por email requiere variables SMTP configuradas correctamente.

Conclusión y más recursos

¡Felicidades! Ya instalaste y configuraste Bitwarden en tu servidor dedicado con éxito. También te recomendamos echar un vistazo a estos recursos, que pueden darte ayuda y guía adicional durante la configuración de tu servidor:

• bitwarden.com - Sitio oficial
• https://bitwarden.com/help/ - Centro de ayuda de Bitwarden (Documentación)

¿Tienes preguntas específicas que no se cubren aquí? Para más dudas o asistencia, no dudes en contactar a nuestro equipo de soporte, ¡disponible todos los días para ayudarte! 🙂