Guía Detallada de Instalación Manual de ERPNext v15 en Producción
Esta guía describe paso a paso cómo instalar ERPNext v15 manualmente en modo producción sobre Linux Mint 22.x (basado en Ubuntu 24.04). Incluye instrucciones completas con rutas, usuario, entorno y versiones de cada componente.
Requisitos del Sistema
- Linux Mint 22.x o Ubuntu Server 24.04
- Usuario con privilegios sudo:
usererpnext
- Al menos 2 CPUs, 4 GB de RAM (8 GB recomendado)
- 10 GB de espacio en disco (mínimo)
- Acceso a internet
Versiones de Software Utilizadas
Componente | Versión Requerida |
---|---|
Python | 3.12+ |
MariaDB | 10.6+ |
Redis | 5+ |
Node.js | 18.x |
npm | 9.x |
wkhtmltopdf | 0.12.6 (qt patched) |
Yarn | 1.22.x |
Frappe Bench CLI | Última disponible |
ERPNext | v15.x |
1. Crear usuario del sistema
Usuario y entorno: Root (fuera de entorno virtual)
sudo adduser usererpnext
sudo usermod -aG sudo usererpnext
2. Instalar dependencias del sistema
Usuario y entorno: usererpnext
(fuera de entorno virtual)
sudo apt update && sudo apt upgrade -y
sudo apt install git python3-dev python3-pip python3-setuptools python3-venv software-properties-common mariadb-server redis-server xvfb libfontconfig wkhtmltopdf curl nginx supervisor -y
3. Crear entorno y carpeta para el proyecto
Ruta: /home/usererpnext/erpnext
Usuario y entorno: usererpnext
fuera del entorno virtual
mkdir -p ~/erpnext && cd ~/erpnext
python3 -m venv env
source env/bin/activate
4. Instalar Bench CLI
Usuario: usererpnext
(dentro de entorno virtual env
)
pip install frappe-bench
5. Crear el proyecto Bench
Ruta: /home/usererpnext/erpnext
Usuario y entorno: usererpnext
con env
activado
bench init --skip-redis-config-generation --frappe-branch version-15 frappe-bench
cd frappe-bench
6. Crear sitio y base de datos
Ruta: /home/usererpnext/erpnext/frappe-bench
Usuario y entorno: usererpnext
con env
activado
bench new-site sitioEjemplo.local
Proporciona la contraseña del root de MariaDB cuando se solicite.
7. Instalar la app ERPNext
Ruta: /home/usererpnext/erpnext/frappe-bench
Usuario y entorno: usererpnext
con env
activado
bench get-app --branch version-15 erpnext
bench --site sitioEjemplo.local install-app erpnext
8. Configurar producción
Ruta: /home/usererpnext/erpnext/frappe-bench
Usuario y entorno: usererpnext
con env
activado
sudo bench setup production usererpnext
Esto configura supervisor
, nginx
y los servicios del sitio.
9. Verificar servicios activos
Usuario: usererpnext
(fuera del entorno virtual)
sudo supervisorctl status
Si hay errores (ej. BACKOFF), revisar:
sudo nano /home/usererpnext/erpnext/frappe-bench/config/supervisor.conf
Asegurarse que los comandos de workers usen:
command=/home/usererpnext/erpnext/frappe-bench/env/bin/bench worker --queue default
Actualizar:
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl restart all
10. Verificar y corregir archivos estáticos (assets)
Ruta: /home/usererpnext/erpnext/frappe-bench
Usuario y entorno: usererpnext
con env
activado
bench use sitioEjemplo.local
bench build --production
sudo supervisorctl restart all
11. Revisar configuración nginx
Usuario: usererpnext
(fuera del entorno virtual)
sudo nginx -t
sudo systemctl reload nginx
12. Acceso a ERPNext
Desde un navegador web:
http://sitioEjemplo.local
http://192.168.1.X
13. Activar el programador (scheduler)
Ruta: /home/usererpnext/erpnext/frappe-bench
Usuario y entorno: usererpnext
con env
activado
bench --site sitioEjemplo.local set-config -g enable_scheduler true
sudo supervisorctl restart all
ERPNext v15 ahora está corriendo en producción correctamente.
Verificar estado:
bench --site sitioEjemplo.local doctor