aastom / frappe_containers

Single image containers for Frappe/ERPNext apps

Clone repo and change working directory

git clone https://github.com/castlecraft/frappe_containers
cd frappe_containers

Clone required apps

git clone https://github.com/frappe/payments -b develop --origin upstream --depth 1 repos/payments
git clone https://github.com/frappe/erpnext -b version-14 --origin upstream --depth 1 repos/erpnext
git clone https://github.com/resilient-tech/india-compliance -b version-14 --origin upstream --depth 1 repos/india_compliance

Build image

With buildah

buildah build -t ghcr.io/castlecraft/frappe_containers/erpnext:latest -f images/production/Containerfile .

Or with docker

docker build -t ghcr.io/castlecraft/frappe_containers/erpnext:latest -f images/production/Containerfile .

Start containers

With podman-compose

podman-compose up -d

Or with docker compose

docker compose up -d
# or
docker-compose up -d

Environment Variables

No script except nginx-entrypoint.sh uses environment variables.

Variables used are as follows:

• BACKEND: Set to {host}:{port}, defaults to 0.0.0.0:8000
• SOCKETIO: Set to {host}:{port}, defaults to 0.0.0.0:9000
• UPSTREAM_REAL_IP_ADDRESS: Set Nginx config for ngx_http_realip_module#set_real_ip_from, defaults to 127.0.0.1
• UPSTREAM_REAL_IP_HEADER: Set Nginx config for ngx_http_realip_module#real_ip_header, defaults to X-Forwarded-For
• UPSTREAM_REAL_IP_RECURSIVE: Set Nginx config for ngx_http_realip_module#real_ip_recursive Set defaults to off
• FRAPPE_SITE_NAME_HEADER: Set proxy header X-Frappe-Site-Name and serve site named in the header, defaults to $host, i.e. find site name from host header.
• PROXY_READ_TIMEOUT: Upstream gunicorn service timeout, defaults to 120
• CLIENT_MAX_BODY_SIZE: Max body size for uploads, defaults to 50m

To bypass nginx-entrypoint.sh, mount desired /etc/nginx/conf.d/default.conf and run nginx -g 'daemon off;' as container command.