Instalar un servidor en casa

Una versión de servidor incluye la pila Docker de Supabase, WuselWall, la app web y la herramienta wuselwall para instalar, actualizar y hacer copias.

Los ejemplos usan api.example.org para la API y web.example.org para la app. Sustitúyelos por tus direcciones.

Preparativos

• Una máquina Linux siempre encendida con Docker y Docker Compose v2, acceso SSH y permiso para ejecutar Docker.
• 4 GB de memoria para WuselWall y 10 GB libres. x86-64 está probado; ARM, incluido Raspberry Pi 5, aún no.
• Un dominio con nombres api. y web. hacia tu IP pública. Si cambia, usa DNS dinámico.
• Redirección de TCP 80 y 443 hacia el servidor.

Sin puertos abiertos puedes usar un túnel Cloudflare, pero Cloudflare descifra el tráfico y puede verlo. Instala sin --caddy y usa los destinos del proxy descritos abajo. Un VPN como WireGuard o Tailscale mantiene privado el servidor, pero cada dispositivo debe usarlo y las suscripciones de calendario externas pueden no funcionar.

1. Instalar

Elige una versión en Releases. 1.0.0 es un ejemplo de número, no una versión garantizada. En el servidor:

curl -fsSL https://github.com/wuselwall/wuselwall-app/releases/download/server-v1.0.0/wuselwall-server-1.0.0.tar.gz | tar xz
cd wuselwall
./wuselwall install --api https://api.example.org --web https://web.example.org --language es --caddy

--language elige el idioma de los correos (de, en, fr, es, alemán por defecto), no el de la app. Docker descarga varios gigabytes. La herramienta genera las claves en stack/.env, arranca Caddy con certificados Let’s Encrypt, prepara base y tareas programadas y muestra un enlace de configuración con QR, con código de un solo uso. No hace falta Node.js ni otro servidor web.

Conserva stack/.env enseguida

Guárdalo en el gestor de contraseñas. Contiene las claves para mantener conectados los dispositivos tras restaurar. Nunca lo regeneres en un servidor existente.

Si aún no hay publicación, constrúyela en un ordenador con Git, rsync y Flutter:

git clone https://github.com/wuselwall/wuselwall-app.git && cd wuselwall-app
scripts/build-server-release.sh 0.1.0
scp dist/wuselwall-server-0.1.0.tar.gz server:

Descomprime después en el servidor. --skip-web construye sin Flutter y sin incluir app web.

2. Conectar la app

La app web lee la configuración de la instalación al cargar, aunque el navegador recuerde otra dirección. Sin conexión usa la última. Si cambia la dirección, inicia sesión otra vez.

Abre el enlace de configuración o escanea su QR. Incluye servidor y código; la app lo conserva durante el acceso por correo y no lo vuelve a pedir para la nueva familia.

También puedes escribir api.example.org. Un QR antiguo con solo dirección no lleva el código: introdúcelo una vez al crear el hogar. ./wuselwall setup-token genera otro mientras no exista familia. No publiques ni código ni enlace.

3. Copias de seguridad

Añade al crontab o planificador del NAS:

30 3 * * * BACKUP_DIR=/srv/backups/wuselwall /path/to/wuselwall/wuselwall backup nightly

La herramienta comprueba las copias y conserva 14 días. Sin BACKUP_DIR van a backups/ junto a ella. Usa preferentemente otro disco y una copia externa. Prueba la restauración.

Idioma de los correos

./wuselwall language es

Se admiten los cuatro idiomas. Cambia MAIL_LANGUAGE, asuntos y plantillas, y reinicia solo autenticación y funciones. Conserva claves y preferencia en futuras actualizaciones. Las instalaciones antiguas sin valor usan alemán. Desde una copia del repositorio, utiliza scripts/remote-stack.sh language es tras desplegar.

Actualizar

./wuselwall update 1.1.0

Se hace una copia antes de descargar y aplicar la versión, con base, app web y tareas programadas. Si usabas acceso Apple o Google, consulta antes la migración.

Qué app va con qué servidor

La app comprueba por sí misma, al conectarse, si va con tu servidor, y te avisa cuando la app o el servidor necesitan una actualización. Cada app entiende la API de su servidor y la anterior; el servidor indica además la app más antigua con la que todavía funciona. Lo que está en marcha se ve en la app en Ajustes → Versiones, por ejemplo «App 1.1.0 · Servidor 0.3.0 · API 1». A partir del servidor 0.3.0, el servidor indica ahí su versión; la app solo ofrece el reconocimiento de texto si el servidor lo tiene instalado.

Servidores

Versión	Fecha	API	App como mínimo
0.4.0	2026-10-24	1	1.0.0
0.3.0	2026-10-24	1	1.0.0
0.2.0	2026-10-24	1	1.0.0

Apps

Versión	Fecha	Funciona con servidores de API
1.3.0	2026-10-24	1
1.2.1	2026-10-24	1
1.2.0	2026-10-24	1
1.1.0	2026-10-24	1
1.0.2	2026-10-21	1

Actualizaciones coordinadas

No uses Watchtower ni actualizaciones automáticas de contenedores del NAS para esta pila. Usa wuselwall update para mantener versiones compatibles.

Comandos útiles

Comando	Función
./wuselwall status	Estado de servicios
./wuselwall logs auth	Registros de auth; también db, rest, realtime, functions, caddy
./wuselwall backup	Copia inmediata
./wuselwall setup-token	Nuevo código antes de crear el hogar
./wuselwall compose …	Comando Docker Compose de la pila

Studio está desactivado. Con --studio, accede por túnel SSH: ssh -L 54421:172.17.0.1:54421 server, después http://127.0.0.1:54421. Los datos están en DASHBOARD_USERNAME y DASHBOARD_PASSWORD de stack/.env.

Tu proxy en lugar de Caddy

Instala sin --caddy si ya tienes nginx, Traefik u otro proxy. La pila escucha en 172.17.0.1:54421.

• Para la API, reenvía /auth/v1/, /rest/v1/, /realtime/v1/ con WebSockets y /functions/v1/ a http://172.17.0.1:54421. Reenvía /.well-known/wuselwall.json a /functions/v1/server-info de ese destino. Los demás caminos, incluido /rest/v1/ sin continuación, devuelven 404.
• Para web, sirve stack/volumes/web, usa index.html para caminos desconocidos y reenvía el mismo archivo de descubrimiento.

stack/volumes/caddy/Caddyfile sirve de modelo. Si el proxy está en otra máquina, cambia GATEWAY_BIND a una dirección accesible y ejecuta ./wuselwall compose up -d.