Manual de ERPNext v15 en Producción - Linux Mint

:hammer_and_wrench: 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.


:clipboard: 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

:package: 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

:white_check_mark: ERPNext v15 ahora está corriendo en producción correctamente.

Verificar estado:

bench --site sitioEjemplo.local doctor
2 Likes