2
0
mirror of https://github.com/frappe/frappe_docker.git synced 2024-11-09 14:50:58 +00:00
Docker images for production and development setups of the Frappe framework and ERPNext
Go to file
Revant Nandgaonkar cd42a60f8e
Merge pull request #455 from revant/docs-pwd-admin-password
docs: mention PWD admin credentials
2021-04-10 21:05:17 +05:30
.github fix stale issues messages 2020-03-29 22:45:34 +01:00
.vscode Added an opinionated set of extensions that will provide a common base for development and tutorials 2020-04-19 14:00:35 +01:00
build feat: Add a flag to skip generating default NGINX config 2021-03-26 21:06:27 +05:30
devcontainer-example fix: gitignore .devcontainer 2020-08-01 23:27:56 +05:30
development Update README.MD for clarity 2020-12-02 19:52:40 +05:30
docs chore: change ci script to build v13 2021-04-02 07:26:44 +05:30
installation rootless containers 2021-02-20 10:54:01 +00:00
tests chore: change ci script to build v13 2021-04-02 07:26:44 +05:30
.dockerignore chore: cleanup redundant files 2020-03-02 23:10:16 +05:30
.gitignore fix: gitignore .devcontainer 2020-08-01 23:27:56 +05:30
.travis.yml chore: change ci script to build v13 2021-04-02 07:26:44 +05:30
CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md 2020-09-15 11:23:42 -07:00
CONTRIBUTING.md docs: improve docs 2021-02-25 15:30:03 +05:30
deploy_key.enc chore: update deploy_key for travis 2020-06-17 10:31:18 +05:30
docker-compose.yml chore: add SKIP_NGINX_TEMPLATE_GENERATION to compose 2021-03-30 13:51:20 +05:30
env-example chore: add SKIP_NGINX_TEMPLATE_GENERATION to compose 2021-03-30 13:51:20 +05:30
env-local chore: add SKIP_NGINX_TEMPLATE_GENERATION to compose 2021-03-30 13:51:20 +05:30
env-production chore: add SKIP_NGINX_TEMPLATE_GENERATION to compose 2021-03-30 13:51:20 +05:30
frappe-installer rootless containers 2021-02-20 10:54:01 +00:00
greetings.yml Create greetings.yml 2020-03-24 17:15:27 +00:00
LICENSE.md Rename LICENSE to LICENSE.md 2017-10-02 09:48:51 +05:30
README.md docs: mention PWD admin credentials 2021-04-10 21:03:53 +05:30
travis.py chore: change ci script to build v13 2021-04-02 07:26:44 +05:30

Develop Build Status
Master Build Status

Getting Started

Try in Play With Docker

Try in PWD

Wait for 5 minutes for ERPNext site to be created or check site-creator container logs before opening browser on port 80. (username: Administrator, password: admin)

Setting up Pre-requisites

This repository requires Docker, docker-compose and Git to be setup on the instance to be used.

For Docker basics and best practices. Refer Docker documentation.

Cloning the repository and preliminary steps

Clone this repository somewhere in your system:

git clone https://github.com/frappe/frappe_docker.git
cd frappe_docker

Production Setup

It takes care of the following:

  • Setting up the desired version of Frappe/ERPNext.
  • Setting up all the system requirements: eg. MariaDB, Node, Redis.
  • Configure networking for remote access and setting up LetsEncrypt.

It doesn't take care of the following:

  • Cron Job to backup sites is not created by default.
  • Use CronJob on k8s or refer wiki for alternatives.
  1. Single Server Installs
    1. Single bench. Easiest Install!
    2. Multi bench
  2. Multi Server Installs
    1. Docker Swarm
    2. Kubernetes
  3. Site Operations
  4. Environment Variables
  5. Custom apps for production
  6. Tips for moving deployments
  7. Wiki for optional recipes

Development Setup

It takes care of complete setup to develop with Frappe/ERPNext and Bench, Including the following features:

  • VSCode containers integration
  • VSCode Python debugger
  • Pre-configured Docker containers for an easy start

Start development.

Contributing