frappe_docker/README.md
ubden 0ac9cd8a94 fix: Change port from 8088 back to 8080 (standard Frappe port for SSL)
Port changes:
- HTTP_PORT: 8088 → 8080 (default Frappe port)
- All documentation updated to reflect port 8080
- GitHub Actions tests updated to port 8080
- SSL works correctly with standard port 8080 in Dokploy

Reason:
- Port 8080 is the standard Frappe frontend port
- Dokploy SSL/HTTPS works better with default port
- Consistent with Frappe conventions

Files updated:
- README.md
- dokploy/README.md
- dokploy/QUICKSTART.md
- dokploy/DEPLOYMENT.md
- dokploy/SSL_SETUP.md
- dokploy/SUMMARY.md
- dokploy/CHANGELOG.md
- dokploy/CHECKLIST.md
- dokploy/docker-compose.yml
- .github/workflows/build-dokploy.yml

SSL/HTTPS:
- Dokploy handles SSL termination on port 443
- Internal communication uses port 8080
- HTTPS redirect automatic
- Let's Encrypt auto-renewal
2025-10-14 09:33:46 +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)

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: 8080
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
  • Standard port 8080 with HTTPS support

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 🚀

ERPNext with essential business apps, optimized for Dokploy:

Included Apps: ERPNext, CRM, Helpdesk, Payments
Port: 8080 (HTTPS otomatik)
Build Time: 10-15 min
Disk: 3-4 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: