erpnext
v1.0.2
Published
1. How to add / update new apps (areas to make changes)
Readme
CI HOW-TO
- How to add / update new apps (areas to make changes)
CD HOW-TO
- npm run release / prerelease
- How to issue various bench commands to the sites
Technical Know-How
- details about important configs and env variables for CI and CD to use this repo for new
How to get started with the site on local
- Clone the repo
docker compose updocker compose exec -it backend bench --site erpnext.localhost reinstall -ydocker compose run migrate
Notes
- Change version in
version.txtto build tagged images from the changed version.
Manually Build images
Execute from root of app repo
Clone this repo,
./ci/clone-apps.shSet environment variables,
FRAPPE_VERSIONset to use frappe version during building images. Default isversion-14.ERPNEXT_VERSIONset to use erpnext version during building images. Default isversion-14.VERSIONset the tag version. Default islatest.REGISTRY_NAMEset the registry name. Default is repo nametacten\erpnex-template.BACKEND_IMAGE_NAMEset worker image name. Default isbackend.FRONTEND_IMAGE_NAMEset nginx image name. Default isnginx.
Build,
docker buildx bake -f docker-bake.hcl --loadAdvanced Introduction
- This repo is based on official frappe_docker documentation to build custom apps.
- Fork this repo to build your own image with ERPNext and list of custom Frappe apps.
- Change the
frappeanderpnextversions inbase_versions.jsonto use them as base. These values correspond to tags and branch names on the github frappe and erpnext repo. e.g.version-13,v13.25.1 - Change
ci/clone-apps.shscript to clone your private and public apps. Read comments in the file to update it as per need. - Change
images/backend.Dockerfileto copy and install required apps withinstall-app. - Change
images/frontend.Dockerfileto install ERPNext if required. - Change
docker-bake.hclfor builds as per need. - Workflows from
.github/workflowswill build latest or tagged images using GitHub. - Github Actions Runner will build images automatically and publish to container registry.
