2
0
mirror of https://github.com/frappe/frappe_docker.git synced 2024-09-19 18:49:01 +00:00
Docker images for production and development setups of the Frappe framework and ERPNext
Go to file
2021-12-17 12:24:57 +03:00
.github Update version input description in docker-build-push 2021-12-17 11:59:08 +03:00
.vscode chore(lint): Run prettier 2021-12-10 11:53:43 +03:00
build Rename bench targets 2021-12-17 11:53:09 +03:00
custom_app Add custom app example 2021-12-16 22:34:11 +03:00
devcontainer-example fix: update devcontainer mariadb (#605) 2021-12-06 17:55:24 +05:30
development chore(lint): Run codespell 2021-12-10 11:54:51 +03:00
docs chore(lint): Run prettier 2021-12-10 11:53:43 +03:00
overrides Take advantage of yaml lang: add defaults in compose file. Also require env vars 2021-12-17 11:26:38 +03:00
tests Uncomment tests 2021-12-17 12:24:38 +03:00
.dockerignore Fix dockerignore 2021-12-15 08:41:40 +03:00
.editorconfig chore: Use pre-commit framework (#604) 2021-12-10 11:48:00 +03:00
.gitignore Update gitignore 2021-12-14 15:43:48 +03:00
.pre-commit-config.yaml Update pre-commit config 2021-12-14 15:53:31 +03:00
.shellcheckrc chore(lint): Take hooks configs out so linting works without pre-commit too (#609) 2021-12-10 12:31:44 +03:00
CODE_OF_CONDUCT.md chore(lint): Run prettier 2021-12-10 11:53:43 +03:00
compose.yaml Take advantage of yaml lang: add defaults in compose file. Also require env vars 2021-12-17 11:26:38 +03:00
CONTRIBUTING.md chore(lint): Run prettier 2021-12-10 11:53:43 +03:00
docker-bake.hcl Parse and set short tags from git tag in bake file 2021-12-17 12:24:57 +03:00
example.env Update erpnext example version 2021-12-15 09:00:01 +03:00
LICENSE chore: Rename LICENSE.md to LICENSE (#608) 2021-12-10 16:25:57 +05:30
README.md chore(lint): Run prettier 2021-12-10 11:53:43 +03:00
requirements-dev.txt Move requirements-dev.txt 2021-12-14 15:36:15 +03:00
setup.cfg chore(lint): Take hooks configs out so linting works without pre-commit too (#609) 2021-12-10 12:31:44 +03:00
TODO.md Parse and set short tags from git tag in bake file 2021-12-17 12:24:57 +03:00

Build Stable Build Develop

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