Tutoriales de VPS
Appwrite en un VPS: Docker, HTTPS, permisos y recuperación
Despliega Appwrite con Ubuntu, Docker Compose y Caddy, separando instaladores por versión. Dimensiona recursos, protege proyectos y funciones, evita bucles del proxy, configura SMTP y copia la base, archivos persistentes y claves antes de actualizar.

Appwrite reúne autenticación, bases de datos, archivos, funciones, mensajería y API en un backend propio. Puede servir para una aplicación personal o un producto interno, siempre que mantengas permisos, correo, almacenamiento persistente y actualizaciones. Una VPS alquilada sigue implicando confianza en el proveedor y sus administradores.
Los ejemplos utilizan Ubuntu 24.04, Docker Compose y Caddy. No mezcles versiones: los fragmentos de la serie 1.7 que aparecen aquí son antiguos. La instalación oficial y la última publicación consultadas el 16 de noviembre de 2026 indican 2.7.2 con un asistente. Utiliza la configuración completa y la ruta de migración de la versión elegida.
El mínimo documentado actual es 2 núcleos, 4 GB de RAM, 2 GB de swap y Compose v2. Una máquina de 1 núcleo/2 GB no lo cumple. Un presupuesto de 2 núcleos/4 GB/40 GB SSD es una referencia inicial, sin garantía de producción.
| Recurso | Laboratorio orientativo | Producción pequeña orientativa |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU o más |
| RAM | 4 GB | Unos 8 GB, con medición |
| Disco | Unos 30 GB SSD, según imágenes y datos reales | Unos 80 GB SSD o más |
| Sistema | Ubuntu 22.04/24.04 con Docker compatible | Ubuntu 24.04 LTS |
| Dominio | appwrite.example.com | Dominios propios de aplicación y correo |
Comprueba free -h, df -h y docker stats si compartes la VPS con bases de datos, monitorización o IA. Deja espacio para imágenes, archivos y runtimes de funciones. Consulta dimensionamiento.
sudo apt update
sudo apt install -y ca-certificates curl git
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/appwrite
sudo chown -R "$USER":"$USER" /opt/appwrite
cd /opt/appwrite
El script ejecuta código como root; revísalo o utiliza la instalación por paquetes admitida por Docker. Pertenecer al grupo Docker también da acceso potente al anfitrión. No uses directorios temporales para proyecto y datos.
sudo systemctl enable --now docker
docker version
docker compose version
El siguiente ejemplo histórico no garantiza una instalación actual. No ejecutes literalmente 1.7.x como una etiqueta verificada: un clon superficial puede no contener la referencia y el árbol fuente no equivale siempre a una plantilla de producción.
cd /opt/appwrite
git clone --depth=1 https://github.com/appwrite/appwrite.git source
cd source
git checkout 1.7.x
cp .env.example .env
Para una instalación nueva de 2.7.2, el instalador oficial ofrece un asistente. Mantén privado su puerto temporal:
cd /opt/appwrite
docker run -it --rm \
--publish 127.0.0.1:20080:20080 \
--volume /var/run/docker.sock:/var/run/docker.sock \
--volume "$PWD/appwrite:/usr/src/code/appwrite:rw" \
--entrypoint install appwrite/appwrite:2.7.2
Desde tu ordenador, reenvía 20080 mediante SSH y abre http://localhost:20080. El instalador accede al socket Docker y puede crear contenedores; utiliza una publicación de confianza. Elige hostname final, HTTPS detrás del proxy y backend. El asistente actual selecciona PostgreSQL por defecto y también ofrece MariaDB/MongoDB. Los ejemplos antiguos describen MariaDB, sin ser instrucciones para cambiar un backend existente.
Revisa el .env generado. Este fragmento identifica secretos y nombres antiguos: utiliza las variables que admita tu versión.
_APP_ENV=production
_APP_OPENSSL_KEY_V1=replace-with-a-long-random-secret
_APP_DOMAIN=appwrite.example.com
_APP_DOMAIN_TARGET=appwrite.example.com
_APP_DB_HOST=mariadb
_APP_DB_USER=appwrite
_APP_DB_PASS=replace-with-a-database-password
_APP_DB_SCHEMA=appwrite
_APP_REDIS_HOST=redis
[email protected]
_APP_SYSTEM_EMAIL_NAME=Appwrite
openssl rand -hex 32 genera material aleatorio, pero cada variable puede exigir un formato. Conserva la clave de cifrado, usa credenciales únicas y no publiques secretos en Git. Mantén privados base de datos, Redis, workers y API internas.
Ejecuta Compose en el directorio generado, que no es necesariamente el antiguo directorio source:
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100 appwrite
- Verifica
mariadbcuando utilices MariaDB. - Comprueba que Appwrite alcanza
redisen la topología que use Redis. - Revisa
appwritey los workers por reinicios repetidos. - Comprueba RAM y disco después de descargar e inicializar.
No ignores una cadena de reinicios como si fuera inicialización normal. Consulta errores y prueba una llamada. El túnel antiguo apunta al puerto 80 remoto; adapta el destino al gateway privado:
ssh -L 8080:127.0.0.1:80 root@SERVER_IP
Para el gateway 8080 descrito abajo, usa ssh -L 8080:127.0.0.1:8080 user@SERVER_IP. Mantén la consola privada hasta verificar HTTPS y permisos.
Crea A/AAAA válidos. Si IPv6 no funciona, corrige o elimina ese AAAA antes de solicitar certificados.
sudo apt install -y caddy
sudo nano /etc/caddy/Caddyfile
Caddy y el gateway de Appwrite no pueden ocupar ambos el puerto 80 del anfitrión. Publica el HTTP del gateway como 127.0.0.1:8080:80 y reserva 80/443 públicos para Caddy. El ejemplo antiguo apunta a 80: cambia su upstream a 127.0.0.1:8080 antes de usarlo, porque podría apuntar al propio Caddy.
appwrite.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:80
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
X-Frame-Options "SAMEORIGIN"
}
}
La línea corregida es reverse_proxy 127.0.0.1:8080. Mantén el comportamiento de host/WebSocket y configura el dominio/HTTPS de Appwrite. Usa HSTS, especialmente includeSubDomains, cuando todos los dominios afectados admitan HTTPS.
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
sudo journalctl -u caddy -n 80 --no-pager
Si ya existe una puerta de entrada, integra allí la aplicación vinculada a 127.0.0.1. Consulta Caddy y proxy en lugar de competir por puertos.
Cuando https://appwrite.example.com funcione con HTTPS verificado:
- Crea administrador, proyecto y plataformas Web/Android/iOS/SDK de servidor correspondientes.
- Define hosts y callbacks explícitos; evita un
*amplio donde se admita. - Limita scopes de API y separa desarrollo y producción.
- Usa autenticación sólida, MFA compatible y roles deliberados.
- Entrega a Functions credenciales limitadas, sin claves maestras permanentes.
- Configura SMTP y dominio con SPF, DKIM y DMARC.
- Abre solo administración necesaria y HTTP/HTTPS públicos en el firewall del proveedor; conserva servicios internos privados.
Utiliza red privada o túnel para mantenimiento de 3306/6379. Consulta exposición de bases de datos. Prueba permisos con un cliente normal, no solo con una clave administrativa que los omite.
Necesitas una copia coherente de la base, datos persistentes de uploads/functions y la clave de .env. El ejemplo MariaDB/rutas siguiente es antiguo y no copia automáticamente todos los volúmenes Docker:
cd /opt/appwrite/source
mkdir -p /opt/appwrite/backup
docker compose exec -T mariadb mysqldump -uappwrite -p"$APPWRITE_DB_PASS" appwrite | gzip > /opt/appwrite/backup/appwrite-$(date +%F).sql.gz
tar -czf /opt/appwrite/backup/appwrite-data-$(date +%F).tgz .env docker-compose.yml volumes/
Identifica backend y montajes reales. APPWRITE_DB_PASS no se carga automáticamente desde variables de Appwrite con otro nombre. Usa el cliente de exportación compatible y credenciales protegidas, comprueba el resultado con pipefail y detén escrituras durante copias físicas. Un directorio volumes/ inexistente no contiene los volúmenes Docker.
Copia cada volumen persistente necesario, configuración generada, clave y versiones. Cifra y protege copias externas. Restaura en una máquina limpia con la misma versión; verifica login, descargas, consultas y ejecución de funciones. Sigue los principios de recuperación. Una instantánea sin copia coherente y probada no basta.
Estos comandos antiguos ilustran guardar configuración y recrear contenedores; 1.7.x no es un destino de actualización verificado:
docker compose config > /opt/appwrite/backup/compose-$(date +%F).yaml
git fetch --tags
git checkout 1.7.x
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200
No sigas latest sin supervisión. Fija una versión admitida, prueba migraciones e intermedios requeridos y programa mantenimiento. Una base migrada puede no servir con la imagen anterior: volver atrás puede exigir restaurar datos y claves correspondientes. El archivo de Compose expandido puede contener secretos.
sudo journalctl -u caddy -n 100 --no-pager
docker compose ps
docker compose logs --tail=200 appwrite
ss -lntp | grep -E ':80|:443'
Comprueba también el listener privado 8080. Caddy debe alcanzar el gateway, sin apuntarse a sí mismo; el gateway debe alcanzar API y workers sanos.
Revisa host de API, certificado, WebSocket y callbacks en el navegador, después base/Redis/workers. Para archivos grandes revisa límites reales de aplicación, proxy o CDN. Caddy no tiene un límite de cuerpo fijo universal: inspecciona la configuración.
docker compose ps
docker stats --no-stream
docker inspect appwrite --format '{{.State.OOMKilled}} {{.State.ExitCode}}'
sudo dmesg -T | grep -i -E 'oom|killed process'
Adapta el nombre de contenedor. Comprueba OOM, colas y montajes antes de limpiar; elimina solo imágenes/logs prescindibles confirmados, conserva volúmenes, verifica swap y amplía recursos cuando corresponda. Reducir memoria de workers a ciegas puede empeorar las colas.
- Dominio, HTTPS, API y WebSocket funcionan en la versión elegida.
- Administrador, plataformas, callbacks y permisos de cliente verificados.
- Base, Redis y workers no están expuestos.
.env, claves, base, uploads y funciones tienen copia.- Una instancia separada ha pasado una restauración.
- Versiones, migraciones y reversión con datos están documentadas.
Prueba primero un proyecto. Un backend mantenible requiere que despliegue, permisos y recuperación funcionen juntos antes de recibir usuarios reales.