Как установить ERPNext на Debian 12

ERPNext — это решение для управления ресурсами предприятия (ERP) с открытым исходным кодом. ERPNext может использоваться в различных отраслях, таких как производство, распределение, розничная торговля, торговля, услуги, образование, некоммерческие организации и здравоохранение. Он также предлагает модули, такие как бухгалтерский учет, CRM, продажи, закупки, веб-сайт, электронная коммерция, точка продаж, производство, склад, управление проектами, инвентаризация и услуги.

ERPNext — это платформа ERP для предприятий, лицензированная под лицензией GNU General Public Licence v3. Она написана в основном на Python и JavaScript и была разработана компанией Frappe Technologies Pvt. Ltd. ERPNext — это приложение, написанное на фреймворке frappe, открытом веб-фреймворке на Python и JavaScript.

ERPNext был разработан как альтернатива таким сервисам, как NetSuite от Oracle, QAD, Tython, OpenBrave и Odoo. По функциональности ERPNext схож с Odoo (ранее OpenERP).

В этом руководстве мы проведем вас через установку ERPNext на сервер Debian 12. Вы установите ERPNext с сервером базы данных MariaDB, Nginx в качестве обратного прокси и менеджером процессов Supervisor.

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

Чтобы начать, убедитесь, что у вас есть доступ к:

• Серверу Debian 12.
• Пользователю, не являющемуся root, с правами администратора sudo.
• Доменному имени, указывающему на IP-адрес сервера.

Установка зависимостей

ERPNext — это программное обеспечение ERP и CRM с открытым исходным кодом, написанное на Python. Чтобы установить ERPNext, вам необходимо установить зависимости, такие как Python 3, сервер MariaDB, Node.js, менеджер пакетов Yarn, Nginx, менеджер процессов Supervisor и Redis на ваш сервер Debian.

На первом этапе вы установите зависимости ERPNext из репозитория Debian. Затем вы также проверите каждую зависимость, чтобы убедиться, что все установлено.

Перед установкой зависимостей выполните команду apt update ниже, чтобы обновить индекс пакетов Debian.

sudo apt update

Теперь выполните следующую команду, чтобы установить зависимости для ERPNext, включая Python 3.11, Node.js, NPM, сервер MariaDB, веб-сервер Nginx, менеджер процессов Supervisor и сервер 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

Введите y, чтобы продолжить установку.

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

Проверьте сервер MariaDB, используя следующую команду.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Проверьте службу Nginx, чтобы убедиться, что служба работает и включена.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Теперь проверьте службу менеджера процессов Supervisor, используя команду ниже.

sudo systemctl is-enabled supervisor  
sudo systemctl status supervisor

Затем проверьте Redis, чтобы убедиться, что он доступен и готов к производству ERPNext.

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

Далее проверьте версии Node.js и NPM, используя следующую команду.

node --version  
npm --version

Следующий вывод подтверждает, что установлены Node.js v18.x и NPM 1.22.

Наконец, проверьте версию wkhtmltopdf, используя команду ниже. Вы должны увидеть, что установлена версия wkhtmltopdf 0.12.

wkhtmltopdf --version  
wkhtmltoimage --version

Настройка сервера MariaDB

После установки зависимостей вы настроите свой сервер MariaDB, чтобы убедиться, что он готов к установке ERPNext. Для ERPNext требуется включить формат barracuda и настроить набор символов по умолчанию на utf8mb4. Вы также обеспечите безопасность своего сервера MariaDB с помощью утилиты mariadb-secure-installation.

Выполните команду mariadb-secure-installation ниже, чтобы обеспечить безопасность установки вашего сервера MariaDB.

sudo mariadb-secure-installation

Введите Y, чтобы применить, когда вас спросят о следующих конфигурациях:

• Переключить локальную аутентификацию на unix_socket? Введите n для нет.
• Установить пароль root для MariaDB? Введите y, затем введите новый пароль root для MariaDB и повторите.
• Удалить пользователя по умолчанию анонимного? Введите y, чтобы подтвердить.
• Отключить удаленный вход для пользователя root? Введите y, чтобы подтвердить.
• Удалить тестовую базу данных по умолчанию? Введите y, чтобы подтвердить.
• Перезагрузить привилегии таблиц и применить изменения? Введите y, чтобы подтвердить.

Теперь откройте конфигурацию сервера MariaDB /etc/mysql/mariadb.conf.d/50-server.cnf с помощью следующего редактора nano.

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

Вставьте следующую конфигурацию в раздел [mysqld], чтобы включить формат barracuda и настроить набор символов по умолчанию на 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

Сохраните файл и выйдите из редактора, когда закончите.

Далее откройте файл /etc/mysql/mariadb.conf.d/50-mysql-clients.cnf с помощью редактора nano, чтобы настроить подключение клиента MariaDB.

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

Добавьте следующую конфигурацию в раздел [mysql].

[mysql]  
default-character-set = utf8mb4

Сохраните и выйдите из файла.

Наконец, выполните следующую команду, чтобы перезапустить сервер MariaDB и применить новую конфигурацию.

sudo systemctl restart mariadb

Установка инструмента командной строки Bench

Bench — это инструмент командной строки для управления Frappe Framework, включая приложения и сайты. ERPNext — это веб-приложение, написанное с использованием Frappe Framework, вы должны установить его через Bench.

Завершите следующий раздел, чтобы создать нового пользователя, который будет использоваться для ERPNext, а затем установите утилиту Bench на вашу систему Debian.

Сначала выполните следующую команду, чтобы добавить нового пользователя frappe, введите новый пароль и повторите.

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

Добавьте пользователя frappe в группу sudo, чтобы разрешить ему выполнять команду sudo.

sudo usermod -aG sudo frappe

Далее войдите как новый пользователь frappe и установите пакет frappe-bench или bench через менеджер пакетов pip Python.

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

После установки frappe-bench проверьте его, используя следующую команду. В этом примере bench 5.17 установлен в /usr/local/bin/bench.

which bench  
bench --version

Установка ERPNext через Bench

В этом разделе вы установите ERPNext через командную строку Bench. Вы инициализируете проект Frappe Framework, создадите новый сайт, а затем загрузите и установите приложение ERPNext в проект Frappe.

Сначала выполните команду bench ниже, чтобы инициализировать Frappe Framework 14 в директории frappe-bench.

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

Ниже вы должны увидеть начало установки Frappe Framework.

После инициализации вы должны получить следующий вывод:

Теперь выполните команду ниже, чтобы разрешить пользователям выполнять Frappe Framework. Это позволит таким группам, как www-data, выполнять Frappe Framework.

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

Далее перейдите в директорию установки Frappe Framework ~/frappe-bench и создайте новый сайт erp.howtoforge.local.

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

Ниже приведен вывод, который вы получите после создания нового сайта.

Переключитесь на новый сайт erp.howtoforge.local, выполнив команду bench ниже.

bench use erp.howtoforge.local

После переключения вы должны увидеть вывод Текущий сайт установлен на erp.howtoforge.local.

Теперь выполните команду bench ниже, чтобы загрузить приложения платежей и следующее приложение.

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

После загрузки erpnext выполните следующую команду, чтобы установить его на сайт erp.howtoforge.local. Это также автоматически установит приложение платежей.

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

После завершения установки выполните команду ниже, чтобы включить планировщик и отключить режим обслуживания на сайте erp.howtoforge.local.

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

На этом этапе ERPNext установлен, вы настроите ERPNext, добавив Nginx в качестве обратного прокси и Supervisor в качестве менеджера процессов для вашей установки ERPNext.

Подготовка ERPNext к производству

На этом этапе вы настроите ERPNext для производства, настроив Nginx в качестве обратного прокси и Supervisor в качестве менеджера процессов, что можно сделать автоматически через Bench.

Выполните следующую команду, чтобы настроить установку ERPNext. Это загрузит и установит Ansible, а затем автоматически настроит Nginx в качестве обратного прокси и менеджера процессов Supervisor.

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

Ниже приведена автоматическая конфигурация Nginx и Supervisor для вашей установки ERPNext.

Если возникла ошибка, вы также можете настроить как Nginx, так и Supervisor, используя команду ниже.

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

Далее перезапустите службы Nginx и Supervisor, чтобы убедиться, что новые изменения применяются.

sudo systemctl restart nginx supervisor

Теперь выполните команду ниже, чтобы проверить службу Nginx и убедиться, что служба работает.

sudo systemctl status nginx

Следующий вывод указывает на то, что Nginx работает.

Наконец, выполните команду supervisorctl ниже, чтобы проверить список процессов ERPNext с помощью Supervisor.

sudo supervisorctl status

Если все прошло хорошо, вы должны увидеть каждый процесс со статусом RUNNING.

С настроенными Nginx и Supervisor вы готовы начать установку ERPNext из вашего веб-браузера.

Установка ERPNext через веб-установщик

Запустите ваш веб-браузер и посетите доменное имя вашей установки ERPNext, например http://erp.howtoforge.local/. Если ваша установка ERPNext успешна, вы должны увидеть страницу входа в ERPNext.

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

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

Теперь введите данные вашего первого пользователя ERPNext и нажмите Далее.

Наконец, введите данные вашей организации и нажмите кнопку Завершить настройку, чтобы завершить установку ERPNext.

Если ваша установка успешна, вы должны увидеть панель управления ERPNext, как показано ниже:

Теперь установка ERPNext завершена.

Заключение

Поздравляем! Вы завершили установку ERPNext на Debian 12 с сервером MariaDB и веб-сервером Nginx. Вы установили ERPNext через командную строку Bench на своем сервере Debian, и теперь вы можете использовать ERPNext в качестве системы управления ресурсами вашего предприятия.