Run BigCapital - Accounting and Inventory Software - in Docker 🌱

What is BigCapital?

Bigcapital is a smart and open-source accounting and inventory software, Bigcapital keeps all business finances in right place and automates accounting processes to give the business powerful and intelligent financial statements and reports to help in making decisions. -https://github.com/bigcapitalhq/bigcapital

Installing Docker

  1. Log into the Linux based device
  2. Run the following commands in the terminal
    # install prerequisites
    sudo apt install apt-transport-https ca-certificates git curl software-properties-common gnupg-agent -y
    # add docker gpg key
    curl -fsSL https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)/gpg | sudo apt-key add -
    # add docker software repository
    sudo add-apt-repository "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release) $(lsb_release -cs) stable"
    # install docker
    sudo apt install docker-ce docker-compose containerd.io -y
    # enable and start docker service
    sudo systemctl enable docker && sudo systemctl start docker
    # add the current user to the docker group
    sudo usermod -aG docker $USER
    # reauthenticate for the new group membership to take effect
    su - $USER

Running BigCapital

  1. Continue with the following commands in a terminal window
    # create working directories
    mkdir ~/docker/bigcapital -p
    # clone source code from github
    git clone --depth 1 -b main https://github.com/bigcapitalhq/bigcapital.git ~/docker/bigcapital
    # change directory
    cd ~/docker/bigcapital
    # create .env
    cp .env.example .env
    # edit .env
    nano .env
  2. Edit the following fields in the .env file

    DB_USER=bigcapital_rw
    DB_PASSWORD=BigC@pit4l
    DB_ROOT_PASSWORD=r00tp@ss

    BASE_URL=http://<%DNSorIP%>:8000

    PUBLIC_PROXY_PORT=8000
    PUBLIC_PROXY_SSL_PORT=8443

  3. Press CTRL+O, Enter, CTRL+X to write the changes and exit
  4. Continue with the following commands in the terminal
    # run the container stack
    docker-compose --file docker-compose.prod.yml up -d
  5. Open a web browser and navigate to http://DNSorIP:8000
  6. Click the Sign Up link to create an account
  7. Enter a first name, last name, email address and password > Click Register
  8. Complete the Organization details form > Click Save & Continue
  9. Click Go to dashboard
  10. Welcome to BigCapital

Documentation: https://docs.bigcapital.app/deployment/docker