mirror of
https://github.com/frappe/frappe_docker.git
synced 2025-01-10 17:24:43 +00:00
Docker images for production and development setups of the Frappe framework and ERPNext
5254e2aad3
* ci(Test): Add `workflow_dispatch` trigger * ci(Test): Build and run on push and pr * test: Set failfast, remove ERPNext reference * test: Reveal .env file for logs * ci(Test): Rename step * ci(Test): Fix git tag * test: Add -x flag for debugging * test: Fix failing test * ci(Test): Check if built images are used * ci(Test): Configure trigger paths, don't build on schedule * test: Remove bug * ci: Build and test stable images on PR * fix(frappe-nginx): Get back to `ls` from `find` * check if test passes with erpnext images * fix(frappe-worker): Default sites in backup command * get integration test changes back * chore: Fix linting |
||
---|---|---|
.github | ||
.vscode | ||
build | ||
devcontainer-example | ||
development | ||
docs | ||
installation | ||
tests | ||
.dockerignore | ||
.gitignore | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
docker-bake.hcl | ||
docker-compose.yml | ||
env-example | ||
env-local | ||
env-production | ||
greetings.yml | ||
LICENSE.md | ||
README.md |
Getting Started
Try in Play With Docker
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.
- Single Server Installs
- Single bench. Easiest Install!
- Multi bench
- Multi Server Installs
- Site Operations
- Environment Variables
- Custom apps for production
- Tips for moving deployments
- 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