/frappe_docker-easy-setup

Docker images for production and development setups of the Frappe framework and ERPNext

Primary LanguagePythonMIT LicenseMIT

Build Stable Build Develop

Everything about Frappe and ERPNext in containers.

HOW TO INSTALL, SETUP AND RUN THE FRAPPE (ERPnext) DOCKER IMAGE - the following commands work on UBUNTU.

.................................................................. These are the commands that should work on a clean WSL Ubuntu. ..................................................................

↓

sudo apt update && sudo apt install apt-transport-https ca-certificates curl software-properties-common -y

↓

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg && echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

↓

sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io -y

↓

sudo usermod -aG docker ${USER} && newgrp docker

↓

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

↓

sudo chmod +x /usr/local/bin/docker-compose

↓

mkdir erpnext_docker && cd erpnext_docker

↓

Them download ONLY the docker-compose.yml file

wget https://github.com/HyperUpscale/frappe_docker-easy-setup/blob/main/docker-compose.yml

↓

docker compose -p pwd -f docker-compose.yml up

.................................................................. Once completed, you should be able to open the web UI on port 8088. ..................................................................

Try in Play With Docker

To play in an already set up sandbox, in your browser, click the button below:

Try in PWD

Try on your Dev environment

First clone the repo:

git clone https://github.com/frappe/frappe_docker
cd frappe_docker

Then run: docker compose -f pwd.yml -d

Final steps

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)

If you ran in a Dev Docker environment, to view container logs: docker compose -f pwd.yml -d. Don't worry about some of the initial error messages, some services take a while to become ready, and then they go away.

Documentation

Production

Custom Images

Development

Troubleshoot

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: