TruBudget - a trusted public expenditure tool. A collaborative workflow tool and secured platform to track and coordinate the implementation of donor-funded investment projects.
These instructions will get you a copy of the project up and running on your local machine.
The recommended option to run TruBudget is to use the latest stable docker images via docker-compose. For more detailed information about the installation and the environment variables or alternative ways to setup TruBudget check out the Installation Guide.
Setting required environment variables via .env file
cd path/to/trubudget
cp .env_example .envTip: If you want to checkout a certain version of TruBudget change the
TAGenvironment variable. By default it is set toTAG=master.
Run TruBudget:
sh scripts/master/start-master-node.shThis will start a prod and test instance of TruBudget (blockchain, api, frontend) and test data provisioning. Use docker ps to check on the running containers.
➜ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
41c3453e505c trubudget/frontend:master "/bin/sh -c '/bin/as…" 5 minutes ago Up 5 minutes 0.0.0.0:80->80/tcp trubudget_frontend_1
5dacb07a93a3 trubudget/provisioning:master "npm start" 5 minutes ago Up 5 minutes trubudget_provision-test_1
296e0d16435c trubudget/provisioning:master "npm start" 5 minutes ago Up 5 minutes trubudget_provision-prod_1
c6426a0ee5f5 trubudget/api:master "/bin/sh -c 'npm sta…" 5 minutes ago Up 5 minutes trubudget_testapi_1
27d71e0678d0 trubudget/api:master "/bin/sh -c 'npm sta…" 5 minutes ago Up 5 minutes trubudget_api_1
760e9736c0dc trubudget/blockchain:master "npm start" 5 minutes ago Up 5 minutes 7447/tcp, 8000/tcp trubudget_master_1
a8b3442490b5 trubudget/blockchain:master "npm start" 5 minutes ago Up 5 minutes 7447/tcp, 8000/tcp trubudget_testmaster_1Once the application and the provisioning is done, you can visit the application at:
http://localhost:80
Checkout the Contributer Guide to learn how to set up your environment to start developing and debugging the TruBudget application.
Check out our Trubudget-Wiki to find out how Trubudget works.
| Description | Link |
|---|---|
| How to run e2e-tests? | https://github.com/openkfw/TruBudget/blob/master/doc/wiki/Contributer-Guide/Contributer-Guide.md#end-to-end-tests |
| How to run unit-test? | https://github.com/openkfw/TruBudget/blob/master/doc/wiki/Contributer-Guide/Contributer-Guide.md#unit-tests |