2
0
mirror of https://github.com/frappe/frappe_docker.git synced 2025-01-24 07:38:33 +00:00

Merge pull request #228 from revant/update-docs

Update README
This commit is contained in:
Revant Nandgaonkar 2020-05-05 13:22:18 +05:30 committed by GitHub
commit ed95c2fe78
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -21,6 +21,8 @@ For docker based development refer to this [README](development/README.md)
This repository requires Docker, docker-compose and Git to be setup on the instance to be used. This repository requires Docker, docker-compose and Git to be setup on the instance to be used.
Docker basics and best practices. Refer Docker documentation.
### Cloning the repository and preliminary steps ### Cloning the repository and preliminary steps
Clone this repository somewhere in your system: Clone this repository somewhere in your system:
@ -38,7 +40,7 @@ cp env-example .env
### Setup Environment Variables ### Setup Environment Variables
To get started, copy the existing `env-example` file to `.env` inside the `installation` directory. By default, the file will contain the following variables: To get started, copy the existing `env-example` file to `.env`. By default, the file will contain the following variables:
- `VERSION=edge` - `VERSION=edge`
- In this case, `edge` corresponds to `develop`. To setup any other version, you may use the branch name or version specific tags. (eg. version-12, v11.1.15, v11) - In this case, `edge` corresponds to `develop`. To setup any other version, you may use the branch name or version specific tags. (eg. version-12, v11.1.15, v11)
@ -53,12 +55,16 @@ To get started, copy the existing `env-example` file to `.env` inside the `insta
- `LETSENCRYPT_EMAIL=your.email@your.domain.com` - `LETSENCRYPT_EMAIL=your.email@your.domain.com`
- Email for LetsEncrypt expiry notification. This is only required if you are setting up LetsEncrypt. - Email for LetsEncrypt expiry notification. This is only required if you are setting up LetsEncrypt.
Notes:
- docker-compose-erpnext.yml and docker-compose-frappe.yml set `AUTO_MIGRATE` environment variable to `1`.
- `AUTO_MIGRATE` checks if there is semver bump or git hash change in case of develop branch and automatically migrates the sites on container start up.
- It is good practice to use image tag for specific version instead of latest. e.g `frappe-socketio:v12.5.1`, `erpnext-nginx:v12.7.1`.
### Local deployment for testing ### Local deployment for testing
For trying out locally or to develop apps using ERPNext REST API port 80 must be published. For trying out locally or to develop apps using ERPNext REST API port 80 must be published.
The first command will start the containers; the second command will publish the port of the *-nginx container. Following command will start the needed containers and expose ports.
For Erpnext: For Erpnext: