Tutoriales de VPS
ERPNext en un VPS: Frappe Docker, HTTPS, colas y recuperación
Despliega ERPNext con archivos Frappe Docker compatibles, overrides MariaDB/Redis, inicialización de sitio y aplicación, HTTPS y colas supervisadas. Protege roles y prueba copias completas antes de migrar.

ERPNext integra contabilidad, compras, inventario, ventas, fabricación, recursos humanos y proyectos sobre Frappe. Controlar datos e instalación exige mantener base, colas, permisos y recuperación. Usaremos Ubuntu 24.04, Docker Compose y los contenedores oficiales frappe_docker.
| Uso | CPU | RAM | Disco | Punto de partida |
|---|---|---|---|---|
| Laboratorio | 2 vCPU | 4 GB | 60 GB SSD | Limitar concurrencia sin quitar colas necesarias |
| Equipo pequeño | 4 vCPU | 8 GB | 120 GB NVMe | Espacio de copias separado y SMTP probado |
| Varias empresas/fabricación | 8 vCPU+ | 16 GB+ | 200 GB NVMe+ | Considerar separar base, archivos y colas |
Son presupuestos, sin garantía de rendimiento. 2 GB suele servir solo para una evaluación breve. Reserva aproximadamente 30% de RAM y 25% de disco, midiendo free -h, df -h y docker stats. Consulta dimensionamiento.
Configura DNS funcional para erp.example.com. Abre SSH/HTTP/HTTPS necesarios y mantén MariaDB/Redis privados.
sudo apt update
sudo apt install -y ca-certificates curl git openssl
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/erpnext
sudo chown -R "$USER":"$USER" /opt/erpnext
cd /opt/erpnext
git clone https://github.com/frappe/frappe_docker.git
cd frappe_docker
Revisa el instalador root o usa paquetes soportados; el grupo Docker concede acceso potente. No sigas indefinidamente cambios sin revisar de main:
git fetch --tags
git tag --sort=-version:refname | head -n 10
git rev-parse HEAD
Registra commit probado y tag/digest. Volver al código anterior no revierte una migración de base.
El nombre antiguo .env.example aparece en este patrón:
cp .env.example .env
openssl rand -hex 32
nano .env
chmod 600 .env
Comprueba tu revisión: la plantilla oficial actual es example.env. compose.yaml necesita overrides de base/Redis/publicación o servicios externos equivalentes. pwd.yml es una demo desechable con credenciales de prueba.
Estos valores antiguos muestran ajustes habituales; SITE_NAME, ADMIN_PASSWORD y MYSQL_ROOT_PASSWORD no son variables universalmente consumidas por la base actual:
ERPNEXT_VERSION=v15
DB_PASSWORD=change-a-long-database-password
MYSQL_ROOT_PASSWORD=change-a-long-root-password
ADMIN_PASSWORD=change-a-long-admin-password
SITE_NAME=erp.example.com
HTTP_PUBLISH_PORT=8080
Para MariaDB/Redis/Caddy en una máquina, copia example.env a .env, fija ERPNEXT_VERSION exacto y soportado, sustituye DB_PASSWORD y añade:
COMPOSE_FILE=compose.yaml:overrides/compose.mariadb.yaml:overrides/compose.redis.yaml:overrides/compose.noproxy.yaml
HTTP_PUBLISH_PORT=127.0.0.1:8080
Usa overrides de la misma revisión. MariaDB utiliza DB_PASSWORD como contraseña root: sustituye el ejemplo 123. Conserva sites, db-data y redis-queue-data y no publiques base/Redis.
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 backend
Mantén configurator, backend, frontend, websocket y scheduler, con redis-cache y redis-queue. Plantillas antiguas pueden listar queue-short, queue-default y queue-long; la base actual tiene queue-short y queue-long que atienden también default, sin servicio queue-default separado. Usa nombres reales y protege la configuración expandida con secretos.
Este comando solo sirve si tu configuración declara el perfil:
docker compose --profile create-site run --rm create-site
De lo contrario, utiliza bench new-site dentro de backend. Ejemplo manual antiguo:
docker compose exec backend bench new-site erp.example.com \
--mariadb-root-password "$MYSQL_ROOT_PASSWORD" \
--admin-password "$ADMIN_PASSWORD"
docker compose exec backend bench --site all list-apps
docker compose exec backend bench --site erp.example.com migrate
Proporciona secretos reales de forma protegida: .env de Compose no carga automáticamente variables en tu shell. Usa el hostname final como nombre de sitio o configura FRAPPE_SITE_NAME_HEADER deliberadamente. Crear Frappe no instala ERPNext: añade --install-app erpnext al comando compatible o ejecuta docker compose exec backend bench --site erp.example.com install-app erpnext. Verifica list-apps antes de migrar.
Configura empresa, plan contable, almacenes y roles. Reserva Administrator para administración y usa cuentas restringidas a diario.
Publica frontend en 127.0.0.1:8080 privado:
sudo apt install -y caddy
sudo nano /etc/caddy/Caddyfile
erp.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:8080
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
X-Frame-Options "SAMEORIGIN"
}
}
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://erp.example.com
Caddy gestiona certificados con DNS/80/443 accesibles. reverse_proxy admite WebSocket. Conserva Host, Upgrade y X-Forwarded-Proto, configurando direcciones de proxy confiables en frontend. Usa una sola puerta de entrada y HSTS/includeSubDomains solo con HTTPS funcional.
Configura SMTP, SPF, DKIM y DMARC. Verifica PTR del IP SMTP real; normalmente el proveedor de relay lo controla. Prueba avisos internos antes de envíos masivos.
- Separa roles financieros, comerciales, inventario y auditoría de lectura.
- Crea usuarios/API keys propios por integración, con permisos y rotación.
- Activa MFA administrativo compatible y limita acceso o utiliza VPN.
- Supervisa
queue-short,queue-default,queue-longy scheduler según servicios reales; no inventes un queue-default en la plantilla actual.
docker compose logs --tail=200 queue-short
docker compose logs --tail=200 queue-default
docker compose logs --tail=200 scheduler
docker compose exec backend bench --site erp.example.com show-pending-jobs
Adapta nombres antiguos antes de leer logs. Investiga Redis, memoria de workers, timeouts de API y tareas fallidas repetidas. No borres Redis a ciegas para vaciar colas.
Conserva sites, adjuntos públicos/privados, configuración y claves además de la base:
docker compose exec backend bench --site erp.example.com backup --with-files
docker compose exec backend find sites/erp.example.com/private/backups -maxdepth 1 -type f
Verifica que se crearon archivos válidos. Copia al anfitrión backups, .env, Compose efectivo y commit; cifra copias externas y no publiques .env:
mkdir -p /opt/erpnext/backups
docker cp "$(docker compose ps -q backend):/home/frappe/frappe-bench/sites/erp.example.com/private/backups" /opt/erpnext/backups/
cp .env /opt/erpnext/backups/
docker compose config > /opt/erpnext/backups/compose-$(date +%F).yaml
git rev-parse HEAD > /opt/erpnext/backups/frappe-docker-commit.txt
Incluye site_config.json/common_site_config.json y claves de cifrado. Pausa escrituras para un punto coherente de base/archivos. Al menos mensualmente, restaura en una máquina temporal aislada y prueba base, adjuntos, login, colas y correo sin envíos reales. Consulta recuperación.
Registra tags, digests, docker compose config y copias. Sustituye el marcador entre ángulos por una revisión probada:
git fetch --tags
git checkout <tested-tag-or-commit>
docker compose pull
docker compose up -d
docker compose exec backend bench --site all migrate
docker compose logs --tail=200 backend
Respeta migraciones e intermedios exigidos. Prueba login, listas, impresión, descargas, correo y colas. Si falla la migración, detén cambios; no conectes código antiguo sin comprobar compatibilidad. Restaura la copia correspondiente en aislamiento antes de decidir recuperación.
Empieza por docker compose ps y logs frontend/backend/Caddy. Verifica 8080 privado, DNS, firewall, configurator finalizado y dependencias sanas.
Comprueba websocket, Upgrade, HTTPS y errores del navegador. Mezclar HTTP/HTTPS puede bloquear conexiones.
Usa docker stats --no-stream para localizar presión de base, backend o workers. Ajusta concurrencia, elimina solo imágenes/logs prescindibles y amplía capacidad o separa base cuando corresponda. Analiza consultas lentas en lugar de reiniciar todo.
Comprueba credenciales SMTP, DNS, scheduler y colas. Verifica puerto real y política de salida: 25 afecta SMTP directo; relays suelen usar 587/465.
- Dominio, HTTPS, WebSocket y renovación verificados.
- Base, Redis, aplicación, colas y scheduler sanos o finalizados según función.
- MFA administrativo y permisos normales probados.
- SMTP, SPF, DKIM y DMARC verificados.
- Base, adjuntos,
sites,.envy versiones con copia externa. - Restauración aislada probada, con duración y carencias registradas.
Ejecutar docker compose up inicia el trabajo. Versiones, colas, permisos y recuperación probada hacen mantenible el sistema.
Lecturas relacionadas: