kerwin-cn / frappe_docker

Docker images for production and development setups of the Frappe framework and ERPNext

Everything about Frappe and ERPNext in containers.

Getting Started

To get started you need Docker, docker-compose, and git setup on your machine. For Docker basics and best practices refer to Docker's documentation. After that, clone this repo:

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

Try in Play With Docker

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

Documentation

Production

• List of containers
• Single Compose Setup
• Environment Variables
• Single Server Example
• Setup Options
• Site Operations
• Backup and Push Cron Job
• Port Based Multi Tenancy
• Migrate from multi-image setup
• running on linux/mac

Custom Images

• Custom Apps
• Build Version 10 Images

Development

• Development using containers
• Bench Console and VSCode Debugger
• Connect to localhost services

Troubleshoot

Contributing

If you want to contribute to this repo refer to CONTRIBUTING.md

This repository is only for container related stuff. You also might want to contribute to:

• Frappe framework,
• ERPNext,
• Frappe Bench.