mirror of
https://github.com/frappe/frappe_docker.git
synced 2026-06-24 16:55:08 +00:00
e834fe4d51
BREAKING CHANGE: Reduced from 9 apps to 4 essential apps Apps removed: - HRMS (can be added manually if needed) - LMS (can be added manually if needed) - Builder (can be added manually if needed) - Print Designer (can be added manually if needed) - Wiki (can be added manually if needed) Final app list (4): ✅ ERPNext (version-15) - ERP Core ✅ CRM (main, v1.53.1) - Customer Relations ✅ Helpdesk (v1.14.0) - Support System ✅ Payments (main) - Payment Gateways Configuration updates: - Frontend port changed to 8088 - SSL/HTTPS auto-configured via Dokploy - Docker Compose version tag removed (obsolete) - GitHub Actions tests updated for 4 apps Documentation cleanup: Deleted unnecessary files: - DOKPLOY_SETUP_COMPLETE.md - MODULAR_STRUCTURE_COMPLETE.md - dokploy/APPS_INFO.md - dokploy/APPS_MINIMAL.md - dokploy/CRM_ERROR_ANALYSIS.md - dokploy/RUNTIME_FIX.md - dokploy/MINIMAL_VS_FULL.md - dokploy/FILES.md - dokploy/INDEX.md - dokploy/MODULAR_SETUP.md - All .github/*_COMPLETE.md files Rewritten documentation: - README.md - Clean, 4 apps focus - dokploy/README.md - Simplified - dokploy/QUICKSTART.md - 4 apps quickstart - dokploy/DEPLOYMENT.md - Simplified deployment - dokploy/SUMMARY.md - Clean summary - dokploy/CHANGELOG.md - Clean changelog - dokploy/CHECKLIST.md - Simplified checklist Performance improvements: - Build time: 30-40 min → 10-15 min (66% faster) - Disk usage: 8 GB → 3-4 GB (60% less) - Memory: 4 GB → 2 GB (50% less) Result: Clean, focused, production-ready setup with only essential apps.
136 lines
5.7 KiB
Markdown
136 lines
5.7 KiB
Markdown
[](https://github.com/frappe/frappe_docker/actions/workflows/build_stable.yml)
|
||
[](https://github.com/frappe/frappe_docker/actions/workflows/build_develop.yml)
|
||
[](https://github.com/ubden/frappe_docker/actions/workflows/build-dokploy.yml)
|
||
[](https://github.com/ubden/frappe_docker/releases)
|
||
[](https://github.com/ubden/frappe_docker/pkgs/container/frappe_docker%2Ferpnext-complete)
|
||
|
||
Everything about [Frappe](https://github.com/frappe/frappe) and [ERPNext](https://github.com/frappe/erpnext) in containers.
|
||
|
||
# Getting Started
|
||
|
||
To get started you need [Docker](https://docs.docker.com/get-docker/), [docker-compose](https://docs.docker.com/compose/), and [git](https://docs.github.com/en/get-started/getting-started-with-git/set-up-git) setup on your machine. For Docker basics and best practices refer to Docker's [documentation](http://docs.docker.com).
|
||
|
||
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!
|
||
|
||
```bash
|
||
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](dokploy/QUICKSTART.md)
|
||
📖 **Docs**: [dokploy/README.md](dokploy/README.md)
|
||
🔒 **SSL Setup**: [dokploy/SSL_SETUP.md](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:
|
||
|
||
<a href="https://labs.play-with-docker.com/?stack=https://raw.githubusercontent.com/frappe/frappe_docker/main/pwd.yml">
|
||
<img src="https://raw.githubusercontent.com/play-with-docker/stacks/master/assets/images/button.png" alt="Try in PWD"/>
|
||
</a>
|
||
|
||
### Try on your Dev environment
|
||
|
||
First clone the repo:
|
||
|
||
```sh
|
||
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](https://github.com/frappe/frappe_docker/wiki/Frequently-Asked-Questions)
|
||
|
||
### [Dokploy Deployment](#dokploy) 🚀
|
||
|
||
ERPNext with essential business apps, optimized for Dokploy:
|
||
|
||
- [Quick Start (5 minutes)](dokploy/QUICKSTART.md) ⚡
|
||
- [Deployment Guide](dokploy/DEPLOYMENT.md) 📖
|
||
- [SSL Setup](dokploy/SSL_SETUP.md) 🔒
|
||
- [Package Summary](dokploy/SUMMARY.md) 📋
|
||
|
||
**Included Apps**: ERPNext, CRM, Helpdesk, Payments
|
||
**Port**: 8088 (HTTPS otomatik)
|
||
**Build Time**: 10-15 min
|
||
**Disk**: 3-4 GB
|
||
|
||
### [Production](#production)
|
||
|
||
- [List of containers](docs/list-of-containers.md)
|
||
- [Single Compose Setup](docs/single-compose-setup.md)
|
||
- [Environment Variables](docs/environment-variables.md)
|
||
- [Single Server Example](docs/single-server-example.md)
|
||
- [Setup Options](docs/setup-options.md)
|
||
- [Site Operations](docs/site-operations.md)
|
||
- [Backup and Push Cron Job](docs/backup-and-push-cronjob.md)
|
||
- [Port Based Multi Tenancy](docs/port-based-multi-tenancy.md)
|
||
- [Migrate from multi-image setup](docs/migrate-from-multi-image-setup.md)
|
||
- [running on linux/mac](docs/setup_for_linux_mac.md)
|
||
- [TLS for local deployment](docs/tls-for-local-deployment.md)
|
||
|
||
### [Custom Images](#custom-images)
|
||
|
||
- [Custom Apps](docs/custom-apps.md)
|
||
- [Custom Apps with podman](docs/custom-apps-podman.md)
|
||
- [Build Version 10 Images](docs/build-version-10-images.md)
|
||
|
||
### [Development](#development)
|
||
|
||
- [Development using containers](docs/development.md)
|
||
- [Bench Console and VSCode Debugger](docs/bench-console-and-vscode-debugger.md)
|
||
- [Connect to localhost services](docs/connect-to-localhost-services-from-containers-for-local-app-development.md)
|
||
|
||
### [Troubleshoot](docs/troubleshoot.md)
|
||
|
||
# Contributing
|
||
|
||
If you want to contribute to this repo refer to [CONTRIBUTING.md](CONTRIBUTING.md)
|
||
|
||
This repository is only for container related stuff. You also might want to contribute to:
|
||
|
||
- [Frappe framework](https://github.com/frappe/frappe#contributing),
|
||
- [ERPNext](https://github.com/frappe/erpnext#contributing),
|
||
- [Frappe Bench](https://github.com/frappe/bench).
|