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
clone frappe-docker repo
sites = [erp.sprinklersnorthwest.com] email = support@lathourhosting.org admin_pass db_pass
cd frappe-docker
cp .env.example .env
Write inside of env: f"ERPNEXT_VERSION={erpnext_version}\n", f"DB_PASSWORD={db_pass}\n", "DB_HOST=db\n", "DB_PORT=3306\n", "REDIS_CACHE=redis-cache:6379\n", "REDIS_QUEUE=redis-queue:6379\n", "REDIS_SOCKETIO=redis-socketio:6379\n", f"LETSENCRYPT_EMAIL={email}\n", f"SITE_ADMIN_PASS={admin_pass}\n", f"SITES={quoted_sites}\n",
sudo docker compose --project-name brotherton -f compose.yaml -f overrides/compose.mariadb.yaml -f overrides/compose.redis.yaml -f overrides/compose.https.yaml --env-file .env config
Make images/production/Containerfile available as a package on githaven? need to replace the erpnext repo argument inside it. inside of compose.yaml, replace "image: frappe/erpnext" with the above package.
sudo docker compose -p brotherton -f compose.yaml up -d
The "erpnext" in this command is probably fine, I think the bench get-app gets the erpnext repository and puts it into an erpnext "app", regardless of what the erpnext repo env variable is.
sudo docker compose -p brotherton exec backend bench new-site sitename --no-mariadb-socket --db-root-password db_pass --admin-password admin_pass --install-app erpnext --set-default
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: