Everything about Frappe and ERPNext in containers.

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

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)

• 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 Apps
• Build Version 10 Images

• Development using containers
• Bench Console and VSCode Debugger
• Connect to localhost services

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:

• Frappe framework,
• ERPNext,
• Frappe Bench.

• Change the .env FRAPPE_SITE_NAME_HEADER=erpnext.kainotomo.com

• docker compose -f compose.yaml -f overrides/compose.noproxy.yaml -f overrides/compose.mariadb.yaml -f overrides/compose.redis.yaml config > kainotomo.yml

• Build worker image to include hrms with command in folder images/kainotomo docker build --no-cache -f ./images/kainotomo/Containerfile . --tag phalouvas/erpnext-worker:14.61.1

• change in file kainotomo.yml image from frappe/erpnext-worker:x.x.x to phalouvas/erpnext-worker:latest

• docker compose --project-name frappe_docker -f kainotomo.yml up -d

• docker compose --project-name frappe_docker -f kainotomo.yml down

• To create a new site with backend shell

  bench new-site development.kainotomo.com --db-name kainotomo_erpnext --mariadb-root-password xxxxxxxx --admin-password xxxxxxxx --install-app hrms --install-app erpnext --install-app payments --install-app paypalstandardpayments --install-app digital_subscriptions --install-app vies_validation --set-default
  bench --site erpnext.kainotomo.com enable-scheduler

  How to schedule backups

  Add crontab entry for backup every 6 hours.

  0 */4 * * * docker compose --project-name frappe exec backend bench --site all backup --with-files > /dev/null
  

• docker compose --project-name phpmyadmin --env-file ~/gitops/phpmyadmin.env -f overrides/compose.phpmyadmin.yaml up -d

• Fetch from remotes
• Fix version 14.61.1 to new in repository gitops
• Add any necessary apps in file ~/kainotomo/frappe_docker/images/custom/apps.json

• Export apps to variable and build image

  export APPS_JSON_BASE64=$(base64 -w 0 ~/frappe_docker/images/custom/v14.json)
  
  docker build  --no-cache --build-arg=FRAPPE_PATH=https://github.com/frappe/frappe \
    --build-arg=FRAPPE_BRANCH=version-14 \
    --build-arg=PYTHON_VERSION=3.11.4 \
    --build-arg=NODE_VERSION=16.18.0 \
    --build-arg=APPS_JSON_BASE64=$APPS_JSON_BASE64 \
    --tag=phalouvas/erpnext-worker:14.62.4 \
    --file=images/custom/Containerfile .
  
  docker push phalouvas/erpnext-worker:14.62.4
  docker tag phalouvas/erpnext-worker:14.62.4 phalouvas/erpnext-worker:version-14
  docker push phalouvas/erpnext-worker:version-14
  

• Export apps to variable and build image

  export APPS_JSON_BASE64=$(base64 -w 0 ~/frappe_docker/images/azure/v15.json)
  
  docker build  --no-cache --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=phalouvas/erpnext-worker:version-15 \
    --file=images/azure/Containerfile .
  
  docker tag phalouvas/erpnext-worker:version-15 phalouvas/erpnext-worker:15.67.0
  docker push phalouvas/erpnext-worker:version-15
  docker push phalouvas/erpnext-worker:15.67.0
  

• docker compose --project-name erpnext-v15 down
• docker compose --project-name erpnext-v15 -f ~/gitops/localhost/erpnext-v15.yaml up -d
• docker images | grep erpnext
• To delete old images in order to free up space use command docker rmi -f phalouvas/erpnext-worker:x.x.x where x.x.x the old version

• SSH on production server ssh -i ~/.ssh/docker-1.pem azureuser@20.234.68.148
• Run deploy script

    ./gitops/docker-1/deploy.sh

• SSH in docker image if you want to run extra commands
  • Get image_id docker ps -f name=backend*
  • docker exec -it image_id /bin/bash
  • bench --site all migrate
• docker images | grep erpnext
• To delete old images in order to free up space use command docker rmi -f phalouvas/erpnext-worker:x.x.x where x.x.x the old version

• SSH on production server ssh -i ~/.ssh/docker-2.pem azureuser@51.138.190.62
• Run deploy script

    ./gitops/docker-2/deploy.sh

• SSH in docker image if you want to run extra commands
  • Get image_id docker ps -f name=backend*
  • docker exec -it image_id /bin/bash
  • bench --site all migrate
• docker images | grep erpnext
• To delete old images in order to free up space use command docker rmi -f phalouvas/erpnext-worker:x.x.x where x.x.x the old version