This is a repo designed to aide setting up frappe/ERPNext on docker.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. Unfortunetly, this container is not curently suited for a production enviorment.
-
Install Docker Community Edition
-
Install Docker Compose (only for Linux users. Docker for Mac, Docker for Windows, and Docker Toolbox already include Docker Compose).
-
Clone this repo and change your working directory to frappe_docker
git clone https://github.com/frappe/frappe_docker.git cd frappe_docker -
Build and start the container, and initialize the bench
./dbench setup docker ./dbench init
Note: This will take a while, as docker will now build the container.
-
Add a new site and start frappe
./dbench new-site site1.local ./dbench setup hosts ./dbench start
-
To use frappe: Open your browser to
localhost:8000.
Username:AdministratorPassword:admin
-
./dbench: Launches you into an interactive shell in the container as user frappe -
./dbench setup docker [ stop | down ]: Starts and builds the docker containers usingdocker-compose up -d -
./dbench setup hosts: Adds all sites to the containers hosts file.
Do this after you've added a new site to avoid errors. -
./dbench -c frappe | root <command to run>: Runs a command in the container, as the selected user -
./dbench -h: Shows this help message -
./dbench <bench command>: Runs a command in bench, (Running./dbench new-site site1.localwill run in the conatiner asbench new-site site1.local)
*Always make sure that your current directory is the root directory of the repo (i.e. frappe_docker/)
For more info on building this docker container refer to this Wiki
Feel free to contribute to this project and make the container better
This project is licensed under the MIT License - see the LICENSE.md file for details