epistemophiliac/frappe_docker
1
0
Fork 0
mirror of https://github.com/frappe/frappe_docker.git synced 2026-06-24 00:35:10 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
frappe_docker/README.md
ubden 6665a28390 docs: Add minimal setup documentation and SSL configuration guide 
New documentation:
- dokploy/APPS_MINIMAL.md: Detailed minimal app setup documentation
- dokploy/MINIMAL_VS_FULL.md: Comparison between minimal and full setup
- dokploy/SSL_SETUP.md: Complete SSL/HTTPS configuration guide for Dokploy

Updates:
- README.md: Updated to reflect minimal setup (5 apps)
  * Emphasized fast deployment (15-20 min)
  * Highlighted minimal disk usage (4-5 GB)
  * Added SSL auto-configuration info
  * Frontend port 8088

Configuration summary:
- Total apps: 5 (ERPNext, HRMS, CRM, Helpdesk, Payments)
- Frontend port: 8088
- SSL: Automatic via Dokploy (Let's Encrypt)
- Build time: 15-20 minutes (50% faster)
- Disk usage: 4-5 GB (40% less)

Benefits:
- Fast and efficient deployment
- Production-ready minimal setup
- Easy to extend with additional apps
- All core features included
2025-10-14 08:42:35 +03:00

5.7 KiB
Raw Blame History

Build Stable Build Develop Build Dokploy GitHub release Docker Image

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! Minimal ve hızlı ERPNext deployment - 5 production-ready app ile 15-20 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 (5):

  • ✅ ERPNext (ERP Core)
  • ✅ HRMS (Human Resource)
  • ✅ CRM (Customer Relations)
  • ✅ Helpdesk (Support System)
  • ✅ Payments (Payment Gateways)

Features:

  • ✅ Fast deployment (15-20 min)
  • ✅ Minimal disk usage (4-5 GB)
  • ✅ Auto SSL/HTTPS (Let's Encrypt)
  • ✅ Production-ready config
  • ✅ Easy to extend (add more apps anytime)

Try in Play With Docker

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

Try in PWD

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 🚀

Minimal ERPNext solution with 5 core apps, optimized for Dokploy:

Included Apps: ERPNext, HRMS, CRM, Helpdesk, Payments
Port: 8088 (HTTPS otomatik)
Build Time: 15-20 min
Disk: 4-5 GB

Production

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: