ERPNext Installation · 7 min read · Oct 12, 2025

Como instalar o ERPNext no Ubuntu 18.04 LTS

ERPNext é um software de gestão empresarial gratuito, de código aberto, moderno e fácil de usar, utilizado por milhares de empresas em todo o mundo. É uma plataforma ERP muito simples que suporta varejo, comércio, serviços, manufatura, recursos humanos, organizações sem fins lucrativos e outros setores. É um sistema ERP poderoso e completo escrito em Python sobre o framework Frappe. Ele usa Node.js para o front end e MariaDB para armazenar seus dados. O ERPNext fornece uma interface baseada na web para realizar tarefas diárias. O ERPNext oferece um sistema de relatórios embutido com integração de suíte de escritório.

Neste tutorial, aprenderemos como instalar e configurar o ERPNext no servidor Ubuntu 18.04 LTS.

Requisitos

  • Um servidor rodando Ubuntu 18.04.
  • Um usuário não-root com privilégios sudo configurado em seu servidor.

Começando

Primeiro, você precisará atualizar seu sistema com a versão mais recente. Você pode fazer isso executando o seguinte comando:

sudo apt-get update -y  
sudo apt-get upgrade -y

Uma vez que seu sistema esteja atualizado, você precisará criar um usuário para o ERPNext.

Você pode fazer isso com o seguinte comando:

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

Em seguida, conceda privilégios sudo ao usuário ERPNext com o seguinte comando:

sudo usermod -aG sudo erpnext

Em seguida, faça login no usuário ERPNext e configure a variável de ambiente com o seguinte comando:

su - erpnext
nano .bashrc

Adicione a seguinte linha:

PATH=$PATH:~/.local/bin/

Salve e feche o arquivo quando terminar. Em seguida, reinicie seu sistema para aplicar todas as alterações.

Instalar Pacotes Necessários

Primeiro, faça login no seu sistema com o usuário erpnext e instale algumas dependências necessárias para o ERPNext em seu sistema.

sudo apt-get install libffi-dev python-pip python-dev libssl-dev wkhtmltopdf -y

Em seguida, instale o servidor Nginx e MariaDB com o seguinte comando:

sudo apt-get install nginx mariadb-server -y

Uma vez que a instalação foi concluída, você precisará fazer algumas alterações no arquivo 50-server.cnf. Você pode fazer isso com o seguinte comando:

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

Faça as seguintes alterações:

[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

[mysql]
default-character-set = utf8mb4

Salve e feche o arquivo. Em seguida, reinicie o serviço MariaDB para aplicar todas as alterações:

sudo systemctl restart mariadb

Agora você pode verificar o status do servidor MariaDB com o seguinte comando:

sudo systemctl status mariadb

Você deve ver a seguinte saída:

? mariadb.service - MariaDB 10.1.38 database server
   Loaded: loaded (/lib/systemd/system/mariadb.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-02-16 06:26:48 UTC; 2h 38min ago
     Docs: man:mysqld(8)
           https://mariadb.com/kb/en/library/systemd/
  Process: 4640 ExecStartPost=/bin/sh -c systemctl unset-environment _WSREP_START_POSITION (code=exited, status=0/SUCCESS)
  Process: 4636 ExecStartPost=/etc/mysql/debian-start (code=exited, status=0/SUCCESS)
  Process: 4505 ExecStartPre=/bin/sh -c [ ! -e /usr/bin/galera_recovery ] && VAR= ||   VAR=`/usr/bin/galera_recovery`; [ $? -eq 0 ]   && systemctl set-
  Process: 4503 ExecStartPre=/bin/sh -c systemctl unset-environment _WSREP_START_POSITION (code=exited, status=0/SUCCESS)
  Process: 4482 ExecStartPre=/usr/bin/install -m 755 -o mysql -g root -d /var/run/mysqld (code=exited, status=0/SUCCESS)
 Main PID: 4607 (mysqld)
   Status: "Taking your SQL requests now..."
    Tasks: 31 (limit: 1111)
   CGroup: /system.slice/mariadb.service
           ??4607 /usr/sbin/mysqld

Aug 16 06:26:47 ubuntu1804 systemd[1]: Starting MariaDB 10.1.38 database server...
Aug 16 06:26:48 ubuntu1804 mysqld[4607]: 2019-02-16  6:26:48 140715015396480 [Note] /usr/sbin/mysqld (mysqld 10.1.38-MariaDB-0ubuntu0.18.04.1) starting
Aug 16 06:26:48 ubuntu1804 systemd[1]: Started MariaDB 10.1.38 database server.
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4642]: Upgrading MySQL tables if necessary.
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4659]: /usr/bin/mysql_upgrade: the '--basedir' option is always ignored
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4659]: Looking for 'mysql' as: /usr/bin/mysql
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4659]: Looking for 'mysqlcheck' as: /usr/bin/mysqlcheck
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4659]: This installation of MySQL is already upgraded to 10.1.38-MariaDB, use --force if you still n
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4677]: Checking for insecure root accounts.
Aug 16 06:26:48 ubuntu1804 /etc/mysql/debian-start[4681]: Triggering myisam-recover for all MyISAM tables and aria-recover for all Aria tables

Instalar Redis e Node.js

Em seguida, você precisará instalar o Redis e o Node.js em seu sistema. Você pode instalá-los executando o seguinte comando:

sudo curl --silent --location https://deb.nodesource.com/setup_8.x | sudo bash -  
sudo apt-get install gcc g++ make -y  
sudo apt-get install nodejs redis-server -y  
sudo npm install -g yarn

Configurar MariaDB

Por padrão, a instalação do MariaDB não é segura, então você precisará protegê-la primeiro. Você pode protegê-la com o seguinte comando:

sudo mysql_secure_installation

Responda a todas as perguntas como mostrado abaixo:

    Enter current password for root (enter for none):
    Set root password? [Y/n]: N
    Remove anonymous users? [Y/n]: Y
    Disallow root login remotely? [Y/n]: Y
    Remove test database and access to it? [Y/n]:  Y
    Reload privilege tables now? [Y/n]:  Y

Uma vez que o MariaDB esteja protegido, faça login no shell do MariaDB com o seguinte comando:

sudo mysql -u root -p

Digite sua senha de root quando solicitado. Em seguida, crie um banco de dados e um usuário para o ERPNext com o seguinte comando:

MariaDB [(none)]> create database erpnextdb;  
MariaDB [(none)]> create user erpnextuser@localhost identified by 'password';

Em seguida, conceda todos os privilégios ao ERPNext com o seguinte comando:

MariaDB [(none)]> GRANT ALL ON erpnextdb.* TO 'erpnextuser'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;  
MariaDB [(none)]> GRANT all privileges on *.* to 'root'@'localhost' IDENTIFIED BY 'admin@123' WITH GRANT OPTION;

Em seguida, limpe os privilégios e saia do shell do MariaDB com o seguinte comando:

MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

Instalar ERPNext

Primeiro, crie um diretório para o ERPNext e conceda as permissões adequadas com o seguinte comando:

sudo mkdir -p /opt/erpnext  
sudo chown -R erpnext /opt/erpnext/

Em seguida, mude o diretório para erpnext e instale o erpnext com o seguinte comando:

cd /opt/erpnext
git clone https://github.com/frappe/bench bench-repo

Saída:

Cloning into 'bench-repo'...
remote: Enumerating objects: 19, done.
remote: Counting objects: 100% (19/19), done.
remote: Compressing objects: 100% (14/14), done.
remote: Total 6144 (delta 10), reused 13 (delta 5), pack-reused 6125
Receiving objects: 100% (6144/6144), 29.70 MiB | 231.00 KiB/s, done.
Resolving deltas: 100% (3924/3924), done.

Em seguida, instale o bench usando o comando pip:

sudo pip install -e bench-repo

Em seguida, inicialize o diretório bench com o framework frappe:

bench init erpnext

Saída:

Building frappe assets...

? Built js/print_format_v3.min.js
? Built js/dialog.min.js
? Built js/web_form.min.js
? Built js/social.min.js
? Built js/modules.min.js
? Built js/form.min.js
? Built js/list.min.js
? Built js/frappe-vue.min.js
? Built js/chat.js
? Built js/desk.min.js
? Built js/control.min.js
? Built css/frappe-rtl.css
? Built css/module.min.css
? Built css/report.min.css
? Built css/form.min.css
? Built css/list.min.css
? Built frappe/css/email.css
? Built css/web_form.css
? Built css/frappe-web.css
? Built css/desk.min.css
? Built js/frappe-web.min.js
? Built js/report.min.js
?  Done in 31.313s
Done in 34.43s.
INFO:bench.utils:setting up backups
no crontab for erpnext
INFO:bench.utils:setting up auto update
no crontab for erpnext
Bench erpnext initialized

Em seguida, mude o diretório para erpnext e crie um novo site para o domínio node1.example.com com o seguinte comando:

bench new-site node1.example.com

Você será solicitado a fornecer sua senha de root do MySQL, como mostrado abaixo:

MySQL root password:

Forneça sua senha de root e pressione Enter. Você deve ver a seguinte saída:

Installing frappe...
Updating DocTypes for frappe        : [========================================]
Updating country info               : [========================================]
Set Administrator password: 
Re-enter Administrator password: 
* Scheduler is disabled *

Em seguida, forneça as permissões adequadas ao erpnext com o seguinte comando:

sudo chown -R erpnext:erpnext /opt/erpnext/erpnext

Finalmente, inicie o servidor com o seguinte comando:

bench start

Você deve ver a seguinte saída:

06:34:02 web.1            |  * Running on http://0.0.0.0:8000/ (Press CTRL+C to quit)
06:34:02 web.1            |  * Restarting with inotify reloader
06:34:03 watch.1          | yarn run v1.13.0
06:34:03 watch.1          | $ node rollup/watch.js
06:34:03 web.1            |  * Debugger is active!
06:34:04 web.1            |  * Debugger PIN: 159-307-235
06:34:13 watch.1          | 
06:34:13 watch.1          | Rollup Watcher Started
06:34:13 watch.1          | 
06:34:13 watch.1          | Watching...
06:34:15 watch.1          | Rebuilding frappe-web.css

Acessar o ERPNext

O ERPNext agora está instalado e escutando na porta 8000. Abra seu navegador e digite a URL http://node1.example.com:8000. Você será redirecionado para a seguinte página:

Login do ERPNext

Agora, forneça o nome de usuário como Administrador e a senha que você forneceu durante a configuração. Em seguida, clique no botão Entrar. Você deve ver a seguinte página:

Selecionar Idioma

Em seguida, escolha seu idioma e clique no botão Próximo. Você deve ver a seguinte página:

Definir nome da empresa

Em seguida, escolha seu país e clique no botão Próximo. Você deve ver a seguinte página:

Adicionar um primeiro usuário

Em seguida, forneça seu nome completo e endereço de e-mail. Em seguida, clique no botão Completar Configuração. Você deve ver a seguinte página:

Painel do ERPNext

Parabéns! você instalou e configurou com sucesso o ERPNext no servidor Ubuntu 18.04. Agora você pode facilmente configurar o ERPNext em um ambiente de produção.

Share: X/Twitter LinkedIn
#ERPNext Installation

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.