accounting/frappe_docker
2
0
Fork 0
mirror of https://github.com/frappe/frappe_docker.git synced 2024-11-08 14:21:05 +00:00
Code Issues Releases Activity
Docker images for production and development setups of the Frappe framework and ERPNext
139 Commits 5 Branches 0 Tags 108 MiB
Python 46.5%
Dockerfile 36.7%
Shell 10.6%
HCL 6.2%
5bd812ccdd
Go to file
Revant Nandgaonkar 5bd812ccdd ci: docker login only before building images
2020-02-21 17:35:26 +05:30
build fix: config generation 2020-02-20 21:48:51 +05:30
conf refactor(frappe-docker): code cleanup and fixes (#63) 2019-04-06 01:20:30 +05:30
frappe-bench Added bench init , start and python tests to curl the site 2017-10-02 09:48:47 +05:30
installation feat: docker-compose services 2020-02-20 22:35:49 +05:30
.dockerignore refactor(frappe-docker): code cleanup and fixes (#63) 2019-04-06 01:20:30 +05:30
.gitignore feat: docker-compose services 2020-02-20 22:35:49 +05:30
.travis.yml ci: docker login only before building images 2020-02-21 17:35:26 +05:30
dbench refactor: dockerfile 2019-11-02 11:17:38 +05:30
docker-compose.yml refactor(frappe-docker): code cleanup and fixes (#63) 2019-04-06 01:20:30 +05:30
Dockerfile chore: install wkhtmltox correctly (#72) 2019-11-03 11:42:36 +05:30
LICENSE.md Rename LICENSE to LICENSE.md 2017-10-02 09:48:51 +05:30
README.md fix(Readme): Typo 2020-01-23 13:21:47 +05:30
test.sh refactor: dockerfile 2019-11-02 11:17:38 +05:30

README.md

Frappe on Docker

Build Status

This is a repo designed to aide setting up frappe/ERPNext on docker.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Unfortunately, this container is not currently suited for a production environment (but we're working towards that goal!).

Build the container and initialize the bench

Note: These instructions assume you have both Docker and Docker Compose installed on your system.

  1. Clone this repo and change your working directory to it:

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

  2. 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.

  3. Add a new site and start Frappe:

    ./dbench new-site site1.local
./dbench setup hosts
./dbench start

  4. Use Frappe: Open your browser to localhost:8000/login. Then log in using the username Administrator and the password admin.

Basic Usage of ./dbench

IMPORTANT: Always make sure that your current directory is the root directory of the repo (i.e. frappe_docker/)

  • ./dbench: Launches you into an interactive shell in the container as the user frappe.

  • ./dbench setup docker [ stop | down ]: Starts and builds the docker containers using docker-compose up -d.

    • stop: Stops the containers with docker-compose stop.
    • down: Deletes the containers and the corresponding volumes with docker-compose down.

  • ./dbench setup hosts: Adds all sites to the containers hosts file. Note: Run 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 (i.e. Running ./dbench new-site site1.local, will run bench new-site site1.local in the container).

For More Info

For more info on building this docker container refer to this Wiki

Contributing

Feel free to contribute to this project and make it better.

License

This project is licensed under the MIT License - see the LICENSE.md file for details