6.4 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=githaven.org/shiloh/frappe_docker:production \ --file=images/custom/Containerfile \ --rm \ --no-cache \ .
sudo docker login githaven.org
setup credential service to hide password
sudo docker push githaven.org/shiloh/frappe_docker:production
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.
sudo docker compose -p frappe exec -it backend bash
To update erpnext, add any commits you want to use to the "production" branch of the erpnext repo on githaven. Then ensure the "backend" container has git repositories in the frappe and erpnext apps:
cd ~/frappe-bench/apps/erpnext
git init
git remote add upstream <repo>
git fetch upstream production
git checkout production --force
git clean -fd
Then pull the latest erpnext, and it will be updated.
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: