TL;DR — Resumen Rápido

Una guía completa para alojar tu propio administrador de contraseñas compatible con Bitwarden utilizando Docker Compose.

Tomar el control de tus propias contraseñas es el logro definitivo de cualquier laboratorio doméstico (homelab). Al alojar Vaultwarden, obtienes la potencia premium absoluta de Bitwarden dentro de tu propia casa.

En esta guía asumo que tienes Docker instalado y listo en una máquina Linux.

Paso 1: Preparar el Entorno

Primero, crea un directorio seguro para no perder accidentalmente nuestra base de datos.

mkdir -p /opt/vaultwarden
cd /opt/vaultwarden

Paso 2: La Configuración de Docker Compose

Crea un archivo llamado docker-compose.yml. Pega esta configuración óptima para producción:

version: '3'
services:
  vaultwarden:
    image: vaultwarden/server:latest
    container_name: vaultwarden
    restart: always
    environment:
      - WEBSOCKET_ENABLED=true
      - SIGNUPS_ALLOWED=true
    volumes:
      - ./vw-data:/data
    ports:
      - 8080:80

La línea SIGNUPS_ALLOWED=true te permite registrar una cuenta. Lo cambiaremos a false tras el paso 5.

Paso 3: Lanzar el Contenedor

Ejecútalo silenciosamente en segundo plano:

docker-compose up -d

Verifica que inició exitosamente:

docker-compose logs -f

Paso 4: Configurar SSL y Reverse Proxy (Crucial)

Vaultwarden ignora todas las funciones críticas si no detecta una conexión HTTPS estricta debido a mecanismos de seguridad de los navegadores.

  1. Abre Nginx Proxy Manager.
  2. Agrega un “Proxy Host” enrutando passwords.tudominio.com al puerto 8080 de tu IP.
  3. Habilita el certificado gratuito de “Let’s Encrypt”.

Paso 5: Desactivar los Registros

Ve a tu dominio HTTPS nuevo y registra tu usuario global. A continuación, cierra la puerta con fuerza de vuelta en tu archivo docker-compose.yml:

    environment:
      - WEBSOCKET_ENABLED=true
      - SIGNUPS_ALLOWED=false # ¡Nadie más podrá registrar cuentas!

Aplica el candado reiniciando el sistema:

docker-compose down && docker-compose up -d

¡Felicidades, tu centro super-secreto de contraseñas está en vivo!