Skip to content
This repository was archived by the owner on Apr 3, 2018. It is now read-only.

pipech/frappe-docker

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

102 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

frappe_docker

  • Docker is an open source project to pack, ship and run any Linux application in a lighter weight, faster container than a traditional virtual machine.

  • Docker makes it much easier to deploy frappe on your servers.

  • This container uses bench to install frappe.

Getting Started

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

See deployment for notes on how to deploy the project on a live system.

Installation

1. Installation Pre-requisites

  • Install Docker Community Edition

  • Install Docker Compose (only for Linux users). Docker for Mac, Docker for Windows, and Docker Toolbox include Docker Compose

2. Build the container and install bench

  • Clone this repo and change your working directory to frappe_docker

    git clone https://github.com/pipech/frappe_docker
    cd frappe_docker
    
  • Build the container and install bench inside the container.

    Make sure your current working directory is frappe_docker which contains the docker-compose.yml and Dockerfile.

    docker-compose up -d
    

    Note: Please do not remove the bench-repo directory the above commands will create

3. Basic Usage

3.1 Usage form Windows Host or Linux Host

  1. Command to start all the containers

    docker compose start

  2. Command to enter your container

     docker exec -it frappe bash
    
  3. First time setup

     cd .. & . init.sh
    
  4. Password

    • MariaDB

      User : root
      Pass : 123
      
    • Sites

      User : Administrator
      Pass : admin
      

3.2 Basic Usage from Linux Host

Make sure your current directory is frappe_docker

  1. First time setup

     ./dbench init
    
  2. Command to start all the containers

     docker-compose start
    
  3. Command to be executed everytime after starting your containers

     ./dbench -s
    
  4. Command to enter your container

     docker exec -it frappe bash 
    
  5. All bench commands can also be directly run from the host machine by using dbench. For instance bench start can be executed by running ./dbench -c start. Just preface the option with ./dbench -c. For more information on dbench run the command ./dbench -h. For more info on how to build this docker container refer to this Wiki To login to Frappe / ERPNext, open your browser and go to [your-external-ip]:8000, probably localhost:8000 The default username is "Administrator" and password is what you set when you created the new site.

Container Configuration Information

ports:

ports:
      - "3307:3307"   mariadb-port
      - "8000:8000"   webserver-port
      - "11000:11000" redis-cache
      - "12000:12000" redis-queue
      - "13000:13000" redis-socketio
      - "9000:9000"   socketio-port
      - "6787:6787"   file-watcher-port

Expose port 3307 inside the container on port 3307 on ALL local host interfaces. In order to bind to only one interface, you may specify the host's IP address as ([<host_interface>:[host_port]])|(<host_port>):<container_port>[/udp] as defined in the docker port binding documentation. The port 3307 of the mariadb container and port 8000 of the frappe container is exposed to the host machine and other containers.

volumes:

volumes:
     - ./frappe-bench:/home/frappe/frappe-bench
     - ./conf/mariadb-conf.d:/etc/mysql/conf.d
     - ./redis-conf/redis_socketio.conf:/etc/conf.d/redis.conf
     - ./redis-conf/redis_queue.conf:/etc/conf.d/redis.conf
     - ./redis-conf/redis_cache.conf:/etc/conf.d/redis.conf

Exposes a directory inside the host to the container.

links:

links:
      - redis-cache
      - redis-queue
      - redis-socketio
      - mariadb

Links allow you to define extra aliases by which a service is reachable from another service.

depends_on:

depends_on:
      - mariadb
      - redis-cache
      - redis-queue
      - redis-socketio

Express dependency between services, which has two effects:

  1. docker-compose up will start services in dependency order. In the following example, mariadb and redis will be started before frappe.

  2. docker-compose up SERVICE will automatically include SERVICE’s dependencies. In the following example, docker-compose up docker_frappe will also create and start mariadb and redis.

Contributing

Feel free to contribute to this project and make the container better

License

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

About

Docker image for frappe-bench

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Shell 81.0%
  • Python 19.0%