Cómo instalar ERPNext en Debian 12

ERPNext es una solución de planificación de recursos empresariales (ERP) de código abierto. ERPNext se puede utilizar en diversas industrias como manufactura, distribución, comercio minorista, comercio, servicios, educación, organizaciones sin fines de lucro y atención médica. También ofrece módulos como contabilidad, CRM, ventas, compras, sitio web, comercio electrónico, punto de venta, manufactura, almacén, gestión de proyectos, inventario y servicios.

ERPNext es una plataforma ERP empresarial licenciada bajo la Licencia Pública General GNU v3. Está escrito principalmente en Python y JavaScript y fue desarrollado por Frappe Technologies Pvt. Ltd. ERPNext es una aplicación escrita bajo el marco frappe, un marco web de código abierto en Python y JavaScript.

ERPNext fue desarrollado como una alternativa a servicios como NetSuite de Oracle, QAD, Tython, OpenBrave y Odoo. En términos de funcionalidad, ERPNext es similar a Odoo (anteriormente OpenERP).

En este tutorial, te guiaremos a través de la instalación de ERPNext en el servidor Debian 12. Instalarás ERPNext con un servidor de base de datos MariaDB, Nginx como proxy inverso y un gestor de procesos supervisor.

Requisitos previos

Para comenzar, asegúrate de tener acceso a:

• Un servidor Debian 12.
• Un usuario no root con privilegios de administrador sudo.
• Un nombre de dominio apuntando a la dirección IP del servidor.

Instalación de dependencias

ERPNext es un software ERP y CRM de código abierto escrito en Python. Para instalar ERPNext, debes instalar dependencias como Python 3, servidor MariaDB, Node.js, gestor de paquetes Yarn, Nginx, gestor de procesos Supervisor y Redis en tu servidor Debian.

En este primer paso, instalarás las dependencias de ERPNext desde el repositorio de Debian. Luego, también verificarás cada dependencia para asegurarte de que todo esté instalado.

Antes de instalar las dependencias, ejecuta el comando apt update a continuación para actualizar tu índice de paquetes de Debian.

sudo apt update

Ahora ejecuta el siguiente comando para instalar las dependencias para ERPNext, incluyendo Python 3.11, Node.js, NPM, servidor MariaDB, servidor web Nginx, gestor de procesos Supervisor y servidor Redis.

sudo apt install python3-dev python3-venv nodejs yarnpkg npm redis-server mariadb-server nginx supervisor fail2ban libffi-dev git python3-pip python3-testresources libssl-dev wkhtmltopdf gcc g++ make

Escribe y para continuar con la instalación.

Una vez que las dependencias estén instaladas, verifica cada dependencia ejecutando el siguiente comando. Verificarás algunos servicios a través del comando systemctl para asegurarte de que cada servicio esté en ejecución y habilitado.

Verifica el servidor MariaDB usando el siguiente comando.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Verifica el servicio Nginx para asegurarte de que el servicio esté en ejecución y habilitado.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Ahora verifica el servicio del gestor de procesos supervisor usando el comando a continuación.

sudo systemctl is-enabled supervisor  
sudo systemctl status supervisor

Luego, verifica Redis para asegurarte de que esté disponible y listo para la producción de ERPNext.

sudo systemctl is-enabled redis-server  
sudo systemctl status redis-server

A continuación, verifica las versiones de Node.js y NPM usando el siguiente comando.

node --version  
npm --version

La siguiente salida confirma que Node.js v18.x y NPM 1.22 están instalados.

Por último, verifica la versión de wkhtmltopdf usando el comando a continuación. Deberías ver que la versión wkhtmltopdf 0.12 está instalada.

wkhtmltopdf --version  
wkhtmltoimage --version

Configuración del servidor MariaDB

Después de instalar las dependencias, configurarás tu servidor MariaDB para asegurarte de que esté listo para la instalación de ERPNext. ERPNext requiere que el formato barracuda esté habilitado y que el conjunto de caracteres predeterminado esté configurado en utf8mb4. También asegurarás tu servidor MariaDB a través de la utilidad mariadb-secure-installation.

Ejecuta el comando mariadb-secure-installation a continuación para asegurar la instalación de tu servidor MariaDB.

sudo mariadb-secure-installation

Ingresa Y para aplicar cuando se te pregunte con las siguientes configuraciones:

• ¿Cambiar la autenticación local a unix_socket? Ingresa n para no.
• ¿Configurar la contraseña de root de MariaDB? Ingresa y, luego escribe la nueva contraseña de root de MariaDB y repite.
• ¿Eliminar el usuario anónimo predeterminado? Ingresa y para confirmar.
• ¿Deshabilitar el inicio de sesión remoto para el usuario root? Ingresa y para confirmar.
• ¿Eliminar la base de datos de prueba predeterminada? Ingresa y para confirmar.
• ¿Recargar los privilegios de la tabla y aplicar cambios? Ingresa y para confirmar.

Ahora abre la configuración del servidor MariaDB /etc/mysql/mariadb.conf.d/50-server.cnf usando el siguiente editor nano.

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

Inserta la siguiente configuración dentro de la sección [mysqld] para habilitar el formato barracuda y configurar el conjunto de caracteres predeterminado en utf8mb4.

[mysqld]  
innodb-file-format=barracuda  
innodb-file-per-table=1  
innodb-large-prefix=1  
character-set-client-handshake = FALSE  
character-set-server = utf8mb4  
collation-server = utf8mb4_unicode_ci

Guarda el archivo y sal del editor cuando termines.

A continuación, abre el archivo /etc/mysql/mariadb.conf.d/50-mysql-clients.cnf usando el editor nano para configurar la conexión del cliente de MariaDB.

sudo nano /etc/mysql/mariadb.conf.d/50-mysql-clients.cnf

Agrega la siguiente configuración a la sección [mysql].

[mysql]  
default-character-set = utf8mb4

Guarda y sal del archivo.

Por último, ejecuta el siguiente comando para reiniciar el servidor MariaDB y aplicar la nueva configuración.

sudo systemctl restart mariadb

Instalación de la herramienta de línea de comandos Bench

Un bench es una herramienta de línea de comandos para gestionar los Frameworks de Frappe, incluyendo aplicaciones y sitios. ERPNext es una aplicación web escrita con el Framework de Frappe, debes instalarla a través de Bench.

Completa la siguiente sección para crear un nuevo usuario que se utilizará para ERPNext, luego instala la utilidad Bench en tu sistema Debian.

Primero, ejecuta el siguiente comando para agregar un nuevo usuario frappe, ingresa la nueva contraseña y repite.

sudo useradd -m -s /bin/bash frappe  
sudo passwd frappe

Agrega el usuario frappe al grupo sudo para permitirle ejecutar el comando sudo.

sudo usermod -aG sudo frappe

A continuación, inicia sesión como el nuevo usuario frappe e instala el paquete frappe-bench o bench a través del gestor de paquetes pip de Python.

su - frappe  
sudo pip3 install frappe-bench --break-system-packages

Una vez que frappe-bench esté instalado, verifícalo usando el siguiente comando. En este ejemplo, bench 5.17 está instalado en /usr/local/bin/bench.

which bench  
bench --version

Instalación de ERPNext a través de Bench

En esta sección, instalarás ERPNext a través de la línea de comandos de Bench. Inicializarás el proyecto del Framework de Frappe, crearás un nuevo sitio y luego descargarás e instalarás la aplicación ERPNext en el proyecto Frappe.

Primero, ejecuta el comando bench a continuación para inicializar el Framework de Frappe 14 en el directorio frappe-bench.

bench init --python python3.11 --frappe-branch version-14 frappe-bench

A continuación, deberías ver que la instalación del Framework de Frappe comienza.

Una vez inicializado, deberías obtener la siguiente salida:

Ahora ejecuta el comando a continuación para permitir que los usuarios ejecuten el Framework de Frappe. Esto permitirá que grupos como www-data ejecuten el Framework de Frappe.

sudo chmod -R o+rx /home/frappe/frappe-bench

A continuación, muévete al directorio de instalación del Framework de Frappe ~/frappe-bench y crea un nuevo sitio erp.howtoforge.local.

cd ~/frappe-bench  
bench new-site erp.howtoforge.local --admin-password 'erpadmin' --mariadb-root-username root --mariadb-root-password 'password'

A continuación, se muestra la salida que obtendrás después de crear el nuevo sitio.

Cambia al nuevo sitio erp.howtoforge.local ejecutando el comando bench a continuación.

bench use erp.howtoforge.local

Una vez cambiado, deberías ver la salida Current Site set to erp.howtoforge.local.

Ahora ejecuta el comando bench a continuación para descargar las aplicaciones de pagos y las siguientes aplicaciones.

bench get-app payments  
bench get-app --branch version-14 erpnext

Una vez que erpnext esté descargado, ejecuta el siguiente comando para instalarlo en el sitio erp.howtoforge.local. Esto también instalará automáticamente la aplicación de pagos.

bench --site erp.howtoforge.local install-app erpnext

Después de que la instalación haya terminado, ejecuta el comando a continuación para habilitar el programador y deshabilitar el mantenimiento en el sitio erp.howtoforge.local.

bench --site erp.howtoforge.local enable-scheduler  
bench --site erp.howtoforge.local set-maintenance-mode off

En este punto, ERPNext está instalado, configurarás ERPNext agregando Nginx como proxy inverso y Supervisor como el gestor de procesos para tu instalación de ERPNext.

Preparando ERPNext para producción

En este paso, configurarás ERPNext para producción configurando Nginx como proxy inverso y Supervisor como gestor de procesos, lo cual se puede hacer automáticamente a través de Bench.

Ejecuta el siguiente comando para configurar la instalación de ERPNext. Esto descargará e instalará Ansible, luego configurará Nginx como proxy inverso y el gestor de procesos Supervisor automáticamente.

sudo pip3 install ansible --break-system-packages  
sudo bench setup production frappe

A continuación se muestra una configuración automática de Nginx y Supervisor para tu instalación de ERPNext.

Si hay un error, también puedes configurar tanto Nginx como Supervisor usando el comando a continuación.

sudo bench setup supervisor  
sudo bench setup nginx  
sudo bench setup production frappe

A continuación, reinicia los servicios de Nginx y Supervisor para asegurarte de que se apliquen los nuevos cambios.

sudo systemctl restart nginx supervisor

Ahora ejecuta el comando a continuación para verificar el servicio Nginx y asegurarte de que el servicio esté en ejecución.

sudo systemctl status nginx

La siguiente salida indica que Nginx está en ejecución.

Por último, ejecuta el comando supervisorctl a continuación para verificar la lista de procesos de ERPNext con el Supervisor.

sudo supervisorctl status

Si todo va bien, deberías ver cada proceso con el estado RUNNING.

Con Nginx y Supervisor configurados, estás listo para comenzar tu instalación de ERPNext desde tu navegador web.

Instalación de ERPNext a través del instalador web

Lanza tu navegador web y visita el nombre de dominio de tu instalación de ERPNext, como http://erp.howtoforge.local/. Si tu instalación de ERPNext es exitosa, deberías ver la página de inicio de sesión de ERPNext.

Ingresa el usuario predeterminado Administrator y la contraseña que has configurado, luego haz clic en Login.

Selecciona el idioma predeterminado, la zona horaria, el país y la moneda. Luego, haz clic en Next para continuar.

Ahora ingresa los detalles de tu primer usuario de ERPNext y haz clic en Next.

Por último, ingresa los detalles de tu organización y haz clic en el botón Complete Setup para completar la instalación de ERPNext.

Si tu instalación es exitosa, deberías obtener el panel de control de ERPNext como el siguiente:

Ahora la instalación de ERPNext ha terminado.

Conclusión

¡Felicidades! Has terminado la instalación de ERPNext en Debian 12 con el servidor MariaDB y el servidor web Nginx. Has instalado ERPNext a través de la línea de comandos de Bench en tu servidor Debian, y ahora puedes usar ERPNext como tu planificación de recursos empresariales para tu organización.