119 lines
4.2 KiB
Markdown
119 lines
4.2 KiB
Markdown
# ERPNext on Docker
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
[English](/README.md) | [简体中文](/README-zh.md)
|
|
|
|
This repository is an **Cloud Native solution** powered by [Websoft9](https://www.websoft9.com), it simplifies the complicated installation and initialization process.
|
|
|
|
## System Requirements
|
|
|
|
The following are the minimal [recommended requirements](https://github.com/frappe/bench):
|
|
|
|
* **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
|
|
```
|
|
|
|
#### Install ERPNext
|
|
|
|
We assume that you are already familiar with Docker, and you can modify [docker-compose file](docker-compose.yml) 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/erp.example.com/$public_ip/g ./.env
|
|
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](docker-compose-production.yml) 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](https://support.websoft9.com/docs/erpnext)
|
|
|
|
## Enterprise Support
|
|
|
|
If you want to get our Enterprise Support to ensure high availability of applications, you can subscribe our [ERPNext Enterprise Support](https://apps.websoft9.com/erpnext)
|
|
|
|
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
|