Как установить ERPNext на Ubuntu 22.04

ERPNext — это бесплатное и открытое ERP-программное обеспечение, используемое производителями, дистрибьюторами и сервисами. Оно разработано с использованием Python, JavaScript и Frappe Framework. Это современное, простое в использовании, бесплатное решение, предназначенное для малых и средних предприятий, которое помогает компаниям управлять всеми аспектами их бизнес-операций. Тысячи компаний по всему миру используют его для управления своими ERP-процессами. Это одна из лучших ERP-систем, поддерживающая производство, дистрибуцию, розничную торговлю, торговлю, услуги, образование, некоммерческие организации и многое другое.

В этом руководстве мы покажем вам, как установить программное обеспечение ERPNext на сервер Ubuntu 22.04.

Предварительные требования

Сервер с установленной Ubuntu 22.04.
Действующий домен, указывающий на ваш сервер.
Настроенный пароль root на вашем сервере.

Начало работы

Сначала вам нужно будет установить некоторые зависимости Python на вашу систему. Вы можете установить их все с помощью следующей команды:

apt-get install python3-dev libffi-dev git python3-pip python3-testresources libssl-dev wkhtmltopdf gcc g++ make python3.10-venv -y

После установки всех зависимостей Python вам нужно будет установить Node.js на ваш сервер.

Сначала добавьте репозиторий Node.js с помощью следующей команды:

curl -sL https://deb.nodesource.com/setup_16.x | bash -

Затем установите Node.js и сервер Redis с помощью следующей команды:

apt-get install nodejs redis-server -y

После установки обоих пакетов установите пакет Yarn, выполнив следующую команду:

npm install -g yarn

Когда вы закончите, вы можете перейти к следующему шагу.

Установка и настройка базы данных MariaDB

По умолчанию MariaDB доступна в стандартном репозитории Ubuntu 22.04. Вы можете установить его с помощью следующей команды:

apt-get install mariadb-server -y

После установки защитите MariaDB и установите пароль root MariaDB с помощью следующей команды:

mysql_secure_installation

Ответьте на все вопросы, как показано ниже, чтобы установить пароль root MariaDB и защитить установку:

Enter current password for root (enter for none):
Set root password? [Y/n] Y
New password:
Re-enter new password:
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

После защиты MariaDB войдите в консоль MariaDB с помощью следующей команды:

mysql -u root -p

Затем вам нужно будет изменить формат файла Innodb MariaDB на Barracuda. Вы можете сделать это, отредактировав файл /etc/mysql/mariadb.conf.d/50-server.cnf:

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

Добавьте / измените следующие строки:

[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

Сохраните и закройте файл, затем перезапустите службу MariaDB, чтобы применить изменения:

systemctl restart mariadb

Установка ERPNext на Ubuntu 22.04

Сначала создайте нового пользователя для запуска ERPNext с помощью следующей команды:

useradd -m -s /bin/bash erpnext

Затем установите пароль для ERPNext с помощью следующей команды:

passwd erpnext

Затем добавьте пользователя ERPNext в группу sudo с помощью следующей команды:

usermod -aG sudo erpnext

Затем войдите в систему как пользователь ERPNext и настройте переменную окружения с помощью следующей команды:

su - erpnext  
nano ~/.bashrc

Добавьте следующую строку:

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

Сохраните файл, затем активируйте переменную окружения с помощью следующей команды:

source ~/.bashrc

Затем создайте каталог для ERPNext с помощью следующей команды:

sudo mkdir /opt/bench

Затем установите владельца на пользователя erpnext:

sudo chown -R erpnext:erpnext /opt/bench

Затем перейдите в каталог /opt/bench и клонируйте репозиторий bench с Git Hub:

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

Затем установите репозиторий bench с помощью команды pip3:

pip3 install -e bench-repo

После установки инициализируйте каталог bench с помощью фреймворка frappe, выполнив следующую команду:

bench init erpnext

Вы должны получить следующий вывод:

? Built js/checkout.min.js
? Built js/dialog.min.js
? Built js/social.min.js
? Built js/web_form.min.js
? Built js/list.min.js
? Built js/chat.js
Browserslist: caniuse-lite is outdated. Please run next command `yarn upgrade caniuse-lite browserslist`
? Built css/frappe-rtl.css
? Built css/printview.css
? Built js/bootstrap-4-web.min.js
? Built js/barcode_scanner.min.js
? Built css/list.min.css
? Built css/report.min.css
? Built frappe/css/email.css
? Built js/frappe-recorder.min.js
? Built js/desk.min.js
? Built css/frappe-chat-web.css
? Built js/frappe-web.min.js
? Built css/form.min.css
? Built css/web_form.css
? Built css/desk.min.css
? Built css/frappe-web-b4.css
? Built js/control.min.js
? Built js/form.min.js
? Built js/data_import_tools.min.js
? Built js/report.min.js
?  Done in 111.35s
Done in 113.33s.
SUCCESS: Bench erpnext initialized

Затем перейдите в каталог erpnext и создайте новый сайт ERPNext с помощью следующей команды:

cd /opt/bench/erpnext  
bench new-site erp.example.com

Вам будет предложено ввести пароль root MariaDB и пароль администратора, как показано ниже:

MySQL root password: 

Installing frappe...
Updating DocTypes for frappe        : [========================================] 100%
Updating country info               : [========================================] 100%
Set Administrator password: 
Re-enter Administrator password: 
* Scheduler is disabled *
Current Site set to erp.example.com

На этом этапе ERPNext установлен в вашей системе.

Настройка ERPNext для производственной среды

Затем вам нужно будет установить Supervisor для управления процессом ERPNext и настроить Nginx как обратный прокси.

Сначала переключите пользователя на ERPNext, затем установите Supervisor и Nginx с помощью следующей команды:

su - erpnext  
sudo apt-get install supervisor nginx -y

Затем установите frappe-bench с помощью следующей команды:

sudo pip3 install frappe-bench

Затем перейдите в каталог /opt/bench/erpnext и настройте ERPNext для производственной среды с помощью следующей команды:

cd /opt/bench/erpnext  
sudo /home/erpnext/.local/bin/bench setup production erpnext

После настройки ERPNext вы должны увидеть следующий вывод:

PLAY RECAP ************************************************************************************************************************************
localhost                  : ok=8    changed=4    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0   

$ sudo systemctl restart supervisor
Port configuration list:

Site erp.example.com assigned port: 80
$ /usr/bin/supervisorctl reread
No config updates to processes
$ /usr/bin/supervisorctl update
$ sudo /usr/sbin/nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
$ sudo systemctl reload nginx

На этом этапе ERPNext настроен с Nginx для производственной среды.

Доступ к веб-интерфейсу ERPNext

Теперь откройте веб-браузер и введите URL http://erp.example.com. Вы будете перенаправлены на страницу входа в ERPNext:

Вход в ERPNext

Укажите имя пользователя как Administrator и пароль, который вы установили ранее, и нажмите кнопку Login. Вы должны увидеть следующую страницу:

Выбор языка

Выберите желаемый язык, страну, часовой пояс и валюту, затем нажмите кнопку Next. Вы должны увидеть следующую страницу:

Создание пользователя

Укажите ваше имя, адрес электронной почты, пароль и нажмите кнопку Complete Setup. Вы должны увидеть панель управления ERPNext на следующей странице:

Панель управления ERPNext

Защита ERPNext с помощью Let’s Encrypt SSL

Сначала вам нужно будет установить клиент Certbot для установки и управления SSL Let’s Encrypt. Вы можете установить его с помощью следующей команды:

sudo apt-get install certbot python3-certbot-nginx -y

После установки выполните следующую команду для установки и настройки SSL Let’s Encrypt для вашего домена:

sudo certbot --nginx -d erp.example.com

Вам будет предложено ввести ваш адрес электронной почты и принять условия обслуживания, как показано ниже:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator nginx, Installer nginx
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Obtaining a new certificate
Performing the following challenges:
http-01 challenge for erp.example.com
Waiting for verification...
Cleaning up challenges
Deploying Certificate to VirtualHost /etc/nginx/conf.d/erpnext.conf

Затем выберите, нужно ли перенаправлять HTTP-трафик на HTTPS, как показано ниже:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

Введите 2 и нажмите Enter, чтобы завершить процесс. Вы должны увидеть следующий вывод:

Redirecting all traffic on port 80 to ssl in /etc/nginx/conf.d/erpnext.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://erp.example.com

You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=erp.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/erp.example.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/erp.example.com/privkey.pem
   Your cert will expire on 2022-09-11. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot again
   with the "certonly" option. To non-interactively renew *all*
   of your certificates, run "certbot renew"
 - Your account credentials have been saved in your Certbot
   configuration directory at /etc/letsencrypt. You should make a
   secure backup of this folder now. This configuration directory will
   also contain certificates and private keys obtained by Certbot so
   making regular backups of this folder is ideal.
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

 - We were unable to subscribe you the EFF mailing list because your
   e-mail address appears to be invalid. You can try again later by
   visiting https://act.eff.org.

На этом этапе ваш сайт ERPNext защищен с помощью SSL Let’s Encrypt. Теперь вы можете безопасно получить доступ к вашему сайту с помощью протокола HTTPS.

Заключение

Поздравляем! Вы успешно установили ERPNext с Nginx и SSL Let’s Encrypt на Ubuntu 22.04. Не стесняйтесь задавать мне вопросы. Вы можете посетить страницу документации ERPNext для получения дополнительной информации.