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. After that, clone this repo:
git clone https://github.com/frappe/frappe_docker
cd frappe_docker
Try in Play With Docker
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)
Documentation
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
Custom Images
Development
Troubleshoot
Shiloh Setup
based on: https://raw.githubusercontent.com/frappe/bench/develop/easy-install.py
git clone ssh://git@githaven.org:2222/Shiloh/frappe_docker.git
sites = [erp.sprinklersnorthwest.com] email = support@lasthourhosting.org
cd frappe_docker
cp example.env .env
Write inside of env:
f"DB_PASSWORD={db_pass}\n",
f"SITE_ADMIN_PASS={admin_pass}\n",
from inside the frappe-docker repo:
APPS_JSON_BASE64=$(base64 -w 0 ./apps.json)
sudo docker build \ --build-arg=FRAPPE_PATH=https://github.com/frappe/frappe \ --build-arg=FRAPPE_BRANCH=version-15 \ --build-arg=PYTHON_VERSION=3.11.6 \ --build-arg=NODE_VERSION=18.18.2 \ --build-arg=APPS_JSON_BASE64=$APPS_JSON_BASE64 \ --tag=local-frappe \ --file=images/custom/Containerfile .
sudo python3 easy-installer.py --prod --email support@lasthourhosting.org --site erp.sprinklersnorthwest.com
sudo docker compose -p frappe exec backend bench use erp.sprinklersnorthwest.com
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: