frappe_docker/README.md

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.

Once completed, chose one of the following two sections for next steps.

🚀 Deploy to Dokploy (Production Ready)

NEW! Deploy ERPNext with 9 pre-installed apps (CRM, LMS, Builder, Print Designer, Payments, Wiki, Twilio Integration, and ERPNext Shipping) to Dokploy in minutes!

Repository: https://github.com/ubden/frappe_docker
Branch: main
Compose Path: dokploy/docker-compose.yml

📚 Quick Start Guide: dokploy/QUICKSTART.md
📖 Full Documentation: dokploy/README.md

Features:

• ✅ One-click deployment with all apps pre-installed
• ✅ Production-optimized configuration
• ✅ Automatic SSL/TLS with Let's Encrypt
• ✅ Built-in health checks and monitoring
• ✅ Easy backup and restore
• ✅ Horizontal scaling ready

Try in Play With Docker

To play in an already set up sandbox, in your browser, click the button below:

Try on your Dev environment

First clone the repo:

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

Then run: docker compose -f pwd.yml up -d

To run on ARM64 architecture follow this instructions

After you clone the repo and cd frappe_docker, run this command to build multi-architecture images specifically for ARM64.

docker buildx bake --no-cache --set "*.platform=linux/arm64"

and then

• add platform: linux/arm64 to all services in the pwd.yml
• replace the current specified versions of erpnext image on pwd.yml with :latest

Then run: docker compose -f pwd.yml up -d

Final steps

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)

If you ran in a Dev Docker environment, to view container logs: docker compose -f pwd.yml logs -f create-site. Don't worry about some of the initial error messages, some services take a while to become ready, and then they go away.

Documentation

Frequently Asked Questions

Dokploy Deployment 🚀

Complete ERPNext solution with 9 pre-installed apps, optimized for Dokploy:

• Quick Start (5 minutes) ⚡
• Deployment Guide 📖
• Package Summary 📋
• Changelog 📝

Included Apps: ERPNext, CRM, LMS, Builder, Print Designer, Payments, Wiki, Twilio Integration, ERPNext Shipping

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
• TLS for local deployment

Custom Images

• Custom Apps
• Custom Apps with podman
• 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.