ERPNext on Docker

Introduction

English | 简体中文

This repository is an Cloud Native solution powered by Websoft9, it simplifies the complicated installation and initialization process.

System Requirements

The following are the minimal recommended requirements:

• OS: Red Hat, CentOS, Debian, Ubuntu or other's Linux OS
• Public Cloud: More than 20+ major Cloud such as AWS, Azure, Google Cloud, Alibaba Cloud, HUAWEIClOUD, Tencent Cloud
• Private Cloud: KVM, VMware, VirtualBox, OpenStack
• ARCH: Linux x86-64, ARM 32/64, Windows x86-64, IBM POWER8, x86/i686
• RAM: 4 GB or more
• CPU: 2 cores or higher
• HDD: at least 20 GB of free space
• Swap file: at least 2 GB
• bandwidth: more fluent experience over 100M

QuickStart

All-in-one Installer

Use SSH to connect your instance and run the automatic installation script below

sudo wget -N https://raw.githubusercontent.com/Websoft9/StackHub/main/docker-installer.sh; sudo bash docker-installer.sh -r erpnext

package install

1.Make package You can get the package as following script

sudo wget -N https://raw.githubusercontent.com/Websoft9/StackHub/main/docker-installer.sh; sudo bash docker-installer.sh -r erpnext -p

2.Install by package Copy package to your server, Use SSH to connect your instance and run the automatic installation script below

sudo bash install-erpnext

Manual Installation

Preparation

If you have not install Docker and Docker-Compose, refer to the following commands to install it:

curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.sh
curl -L "https://github.com/docker/compose/releases/download/v2.1.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
ln -sf /usr/local/bin/docker-compose  /usr/bin
sudo systemctl start docker
sudo usermod -aG docker $USER
newgrp docker

Install ERPNext

We assume that you are already familiar with Docker, and you can modify docker-compose file by yourself

git clone --depth=1 https://github.com/Websoft9/docker-erpnext
cd docker-erpnext
public_ip=`wget -O - https://download.websoft9.com/ansible/get_ip.sh | bash`  
sudo sed -i s/erpnext.example.com/$public_ip/g ./.env
docker network create -d bridge websoft9
docker-compose  up -d

FAQ

Do I need to change the password before docker-compose up?

Yes, you should modify all database password and application password at docker-compose file for production

Docker runing failed for the reason that port conflict?

You should modify ports at docker-compose file and docker-compose again

Why does the erptext port use 8000, which violates the encoding specification of the compose file?

The use of 9001 or other ports will lead to errors in some containers and make the application unable to access normally

The default startup is erpnext12, What should I do if I want to run another version?

If you want to run erpnext13, you only need to change ERPNEXT_VERSION/FRAPPE_VERSIO to V13;Please delete volumes before edit configure

Usage instructions

You can point your browser to: http://Instance's Internet IP:port

The following is the information that may be needed during use

Credentials

By default, the available users are:

Username	Password
Administrator	admin

Services and Ports

Service	Port	Use	Necessity
erpnext	8000	Browser access to ERPNext by http	Y
mariadb	3306	Accessing MySQL database with TCP	Y

Documentation

ERPNext Administrator Guide

Enterprise Support

If you want to get our Enterprise Support to ensure high availability of applications, you can subscribe our ERPNext Enterprise Support

What you get with a Enterprise Support subscription?

• Knowledge: Answers and guidance from product experts
• Support: Everything you need for technical support, e.g Enable HTTPS, Upgrade guide
• Security: Security services and tools to protect your software