6485b93da7
Critical fix: - Dockerfile: Do not delete node_modules folders (socket.io needed at runtime) - Only remove .git folders and Python cache - Preserve all npm packages for WebSocket functionality New documentation: - dokploy/TROUBLESHOOTING.md: Common issues and solutions * WebSocket host not found * socket.io module not found * Frontend restart loop * Site not found errors This fixes: - Frontend restart loop - WebSocket container crashes - socket.io MODULE_NOT_FOUND errors WebSocket requires socket.io, redis, socket.io-redis packages at runtime. These must NOT be deleted in Dockerfile cleanup. |
||
|---|---|---|
| .github | ||
| .vscode | ||
| devcontainer-example | ||
| development | ||
| docs | ||
| dokploy | ||
| images | ||
| overrides | ||
| resources | ||
| tests | ||
| .dockerignore | ||
| .editorconfig | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| .shellcheckrc | ||
| CODE_OF_CONDUCT.md | ||
| compose.yaml | ||
| CONTRIBUTING.md | ||
| docker-bake.hcl | ||
| example.env | ||
| FINAL_SETUP.md | ||
| install_x11_deps.sh | ||
| LICENSE | ||
| pwd.yml | ||
| README.md | ||
| requirements-test.txt | ||
| setup.cfg | ||
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)
Hızlı ve verimli ERPNext deployment - 4 temel uygulama ile 10-15 dakikada hazır!
Repository: https://github.com/ubden/frappe_docker
Branch: main
Compose Path: dokploy/docker-compose.yml
Frontend Port: 8088
SSL: Auto (Let's Encrypt)
📚 Quick Start: dokploy/QUICKSTART.md
📖 Docs: dokploy/README.md
🔒 SSL Setup: dokploy/SSL_SETUP.md
Included Apps (4):
- ✅ ERPNext (ERP Core - Accounting, Inventory, Sales, Manufacturing)
- ✅ CRM (Customer Relations - Lead, Deal Management)
- ✅ Helpdesk (Support System - Tickets, SLA, Knowledge Base)
- ✅ Payments (Payment Gateways - Stripe, PayPal, Razorpay)
Features:
- ✅ Fast deployment (10-15 min)
- ✅ Minimal disk usage (3-4 GB)
- ✅ Auto SSL/HTTPS (Let's Encrypt)
- ✅ Production-ready config
- ✅ Port 8088 with HTTPS support
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/arm64to all services in thepwd.yml - replace the current specified versions of erpnext image on
pwd.ymlwith: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 🚀
ERPNext with essential business apps, optimized for Dokploy:
Included Apps: ERPNext, CRM, Helpdesk, Payments
Port: 8088 (HTTPS otomatik)
Build Time: 10-15 min
Disk: 3-4 GB
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
Development
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: