Como Instalar o ERPNext no Debian 12

ERPNext é uma solução de planejamento de recursos empresariais (ERP) de código aberto. O ERPNext pode ser usado em várias indústrias, como manufatura, distribuição, varejo, comércio, serviços, educação, organizações sem fins lucrativos e saúde. Ele também oferece módulos como contabilidade, CRM, vendas, compras, site, e-commerce, ponto de venda, manufatura, armazém, gerenciamento de projetos, inventário e serviços.

O ERPNext é uma plataforma ERP empresarial licenciada sob a Licença Pública Geral GNU v3. É escrito principalmente em Python e JavaScript e foi desenvolvido pela Frappe Technologies Pvt. Ltd. O ERPNext é um aplicativo escrito sob o frappeframework, um framework web de código aberto em Python e JavaScript.

O ERPNext foi desenvolvido como uma alternativa a serviços como NetSuite da Oracle, QAD, Tython, OpenBrave e Odoo. Em termos de funcionalidade, o ERPNext é semelhante ao Odoo (anteriormente OpenERP).

Neste tutorial, vamos guiá-lo pela instalação do ERPNext no servidor Debian 12. Você instalará o ERPNext com um servidor de banco de dados MariaDB, Nginx como um proxy reverso e um gerenciador de processos Supervisor.

Pré-requisitos

Para começar, certifique-se de ter acesso a:

• Um servidor Debian 12.
• Um usuário não-root com privilégios de administrador sudo.
• Um nome de domínio apontado para o endereço IP do servidor.

Instalando Dependências

O ERPNext é um software ERP e CRM de código aberto escrito em Python. Para instalar o ERPNext, você deve instalar dependências como Python 3, Servidor MariaDB, Node.js, Yarn gerenciador de pacotes, Nginx, gerenciador de processos Supervisor e Redis no seu servidor Debian.

Neste primeiro passo, você instalará as dependências do ERPNext a partir do repositório Debian. Em seguida, você também verificará cada dependência para garantir que tudo esteja instalado.

Antes de instalar as dependências, execute o comando apt update abaixo para atualizar seu índice de pacotes Debian.

sudo apt update

Agora execute o seguinte comando para instalar as dependências do ERPNext, incluindo Python 3.11, Node.js, NPM, servidor MariaDB, servidor web Nginx, gerenciador de processos Supervisor e 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

Digite y para prosseguir com a instalação.

Uma vez que as dependências estejam instaladas, verifique cada dependência executando o seguinte comando. Você verificará alguns serviços via o comando systemctl para garantir que cada serviço esteja em execução e habilitado.

Verifique o servidor MariaDB usando o seguinte comando.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Verifique o serviço Nginx para garantir que o serviço esteja em execução e habilitado.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Agora verifique o serviço do gerenciador de processos Supervisor usando o comando abaixo.

sudo systemctl is-enabled supervisor  
sudo systemctl status supervisor

Em seguida, verifique o Redis para garantir que ele esteja disponível e pronto para a produção do ERPNext.

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

Em seguida, verifique as versões do Node.js e NPM usando o seguinte comando.

node --version  
npm --version

A seguinte saída confirma que o Node.js v18.x e NPM 1.22 estão instalados.

Por fim, verifique a versão do wkhtmltopdf usando o comando abaixo. Você deve ver a versão do wkhtmltopdf 0.12 instalada.

wkhtmltopdf --version  
wkhtmltoimage --version

Configurando o Servidor MariaDB

Após instalar as dependências, você configurará seu servidor MariaDB para garantir que ele esteja pronto para a instalação do ERPNext. O ERPNext requer que o formato barracuda esteja habilitado e o conjunto de caracteres padrão configurado para utf8mb4. Você também irá proteger seu servidor MariaDB através da utilidade mariadb-secure-installation.

Execute o comando mariadb-secure-installation abaixo para proteger a instalação do seu servidor MariaDB.

sudo mariadb-secure-installation

Digite Y para aplicar quando solicitado com as seguintes configurações:

• Mudar a autenticação local para unix_socket? Digite n para não.
• Configurar a senha do root do MariaDB? Digite y, em seguida, digite a nova senha do root do MariaDB e repita.
• Remover o usuário anônimo padrão? Digite y para confirmar.
• Desabilitar login remoto para o usuário root? Digite y para confirmar.
• Remover o banco de dados de teste padrão? Digite y para confirmar.
• Recarregar privilégios de tabela e aplicar alterações? Digite y para confirmar.

Agora abra a configuração do Servidor MariaDB /etc/mysql/mariadb.conf.d/50-server.cnf usando o seguinte editor nano.

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

Insira a seguinte configuração na seção [mysqld] para habilitar o formato barracuda e configurar o conjunto de caracteres padrão para 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

Salve o arquivo e saia do editor quando terminar.

Em seguida, abra o arquivo /etc/mysql/mariadb.conf.d/50-mysql-clients.cnf usando o editor nano para configurar a conexão do cliente MariaDB.

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

Adicione a seguinte configuração à seção [mysql].

[mysql]  
default-character-set = utf8mb4

Salve e saia do arquivo.

Por fim, execute o seguinte comando para reiniciar o servidor MariaDB e aplicar a nova configuração.

sudo systemctl restart mariadb

Instalando a Ferramenta de Linha de Comando Bench

Um bench é uma ferramenta de linha de comando para gerenciar Frameworks Frappe, incluindo aplicativos e sites. O ERPNext é um aplicativo web escrito com o Framework Frappe, você deve instalá-lo via Bench.

Complete a seção a seguir para criar um novo usuário que será usado para o ERPNext, e depois instale a utilidade Bench no seu sistema Debian.

Primeiro, execute o seguinte comando para adicionar um novo usuário frappe, digite a nova senha e repita.

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

Adicione o usuário frappe ao grupo sudo para permitir que ele execute o comando sudo.

sudo usermod -aG sudo frappe

Em seguida, faça login como o novo usuário frappe e instale o frappe-bench ou pacote bench via o gerenciador de pacotes pip Python.

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

Uma vez que o frappe-bench esteja instalado, verifique-o usando o seguinte comando. Neste exemplo, bench 5.17 está instalado em /usr/local/bin/bench.

which bench  
bench --version

Instalando o ERPNext via Bench

Nesta seção, você instalará o ERPNext via a linha de comando Bench. Você inicializará o projeto do Framework Frappe, criará um novo site e, em seguida, fará o download e instalará o aplicativo ERPNext no projeto Frappe.

Primeiro, execute o comando bench abaixo para inicializar o Framework Frappe 14 no diretório frappe-bench.

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

Abaixo você deve ver o início da instalação do Framework Frappe.

Uma vez inicializado, você deve obter a seguinte saída:

Agora execute o comando abaixo para permitir que os usuários executem o Framework Frappe. Isso permitirá que grupos como www-data executem o Framework Frappe.

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

Em seguida, mude para o diretório de instalação do Framework Frappe ~/frappe-bench e crie um novo site erp.howtoforge.local.

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

Abaixo está a saída que você obterá após o novo site ser criado.

Mude para o novo site erp.howtoforge.local executando o comando bench abaixo.

bench use erp.howtoforge.local

Uma vez trocado, você deve ver a saída Current Site set to erp.howtoforge.local.

Agora execute o comando bench abaixo para baixar os pagamentos e os próximos aplicativos.

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

Uma vez que o erpnext esteja baixado, execute o seguinte comando para instalá-lo no site erp.howtoforge.local. Isso também instalará automaticamente o aplicativo de pagamentos.

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

Após a instalação ser concluída, execute o comando abaixo para habilitar o agendador e desabilitar a manutenção no site erp.howtoforge.local.

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

Neste ponto, o ERPNext está instalado, você configurará o ERPNext adicionando o Nginx como um proxy reverso e o Supervisor como o gerenciador de processos para sua instalação do ERPNext.

Preparando o ERPNext para Produção

Neste passo, você configurará o ERPNext para produção configurando o Nginx como um proxy reverso e o Supervisor como um gerenciador de processos, o que pode ser feito automaticamente via Bench.

Execute o seguinte comando para configurar a instalação do ERPNext. Isso fará o download e instalará o Ansible, em seguida, configurará o Nginx como um proxy reverso e o gerenciador de processos Supervisor automaticamente.

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

Abaixo está uma configuração automática do Nginx e Supervisor para sua instalação do ERPNext.

Se houver um erro, você também pode configurar tanto o Nginx quanto o Supervisor usando o comando abaixo.

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

Em seguida, reinicie os serviços Nginx e Supervisor para garantir que as novas alterações sejam aplicadas.

sudo systemctl restart nginx supervisor

Agora execute o comando abaixo para verificar o serviço Nginx e garantir que o serviço esteja em execução.

sudo systemctl status nginx

A seguinte saída indica que o Nginx está em execução.

Por fim, execute o comando supervisorctl abaixo para verificar a lista de processos do ERPNext com o Supervisor.

sudo supervisorctl status

Se tudo correr bem, você deve ver cada processo com o status RUNNING.

Com o Nginx e o Supervisor configurados, você está pronto para iniciar sua instalação do ERPNext a partir do seu navegador web.

Instalação do ERPNext via Instalador Web

Inicie seu navegador web e visite o nome de domínio da sua instalação do ERPNext, como http://erp.howtoforge.local/. Se sua instalação do ERPNext for bem-sucedida, você deverá ver a página de login do ERPNext.

Digite o usuário padrão Administrator e a senha que você configurou, em seguida, clique em Login.

Selecione o idioma padrão, fuso horário, país e a moeda. Em seguida, clique em Next para continuar.

Agora insira os detalhes do seu primeiro usuário do ERPNext e clique em Next.

Por fim, insira os detalhes da sua organização e clique no botão Complete Setup para concluir a instalação do ERPNext.

Se sua instalação for bem-sucedida, você deverá obter o painel do ERPNext como o seguinte:

Agora a instalação do ERPNext está concluída.

Conclusão

Parabéns! Você concluiu a instalação do ERPNext no Debian 12 com o servidor MariaDB e o servidor web Nginx. Você instalou o ERPNext via a linha de comando Bench no seu servidor Debian, e agora pode usar o ERPNext como seu Planejamento de Recursos Empresariais para sua organização.