5.9 KiB
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",
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 \ --rm \ --no-cache \ .
sudo docker image tag NAME:TAG githaven.org/shiloh/NAMEOFREPO:TAG sudo docker login githaven.org setup credential service to hide password sudo docker push githaven.org/shiloh/NAMEOFREPO:TAG https://docs.gitea.com/packages/packages/container
sudo python3 easy-installer.py --prod --email support@lasthourhosting.org --site erp.sprinklersnorthwest.com
bench use should already be done by the installer.
Create a project through the dashboard with the sidebar, then login with the admin account and view the projects page through the other dashboard, you should see edits.
To update erpnext, ensure the "backend" container has git repositories in the frappe and erpnext apps:
git init
git remote add upstream <repo>
git fetch upstream <branch>
git checkout <branch> --force
git clean -fd
Then from ./frappe-bench run:
bench update
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: