# Riki
*Note: Docker should be installed on your system to contribute to and run Riki.*
## Setup Instructions
Before running, ensure you have a configuration file in the root directory, `.env`.
Base your `.env` file on the `.env.template` file provided by the repo.
In particular, edit line 1 to include your secret
## List of Commands
**From the current directory:**
- **Build Docker image:**
```shell
docker-compose build
-
Run Docker image:
docker-compose up
While running, you should see webapp logs. To view in browser, visit:
localhost:5001
-
Stop the Docker image:
- Press
CTRL+C
in the terminal window - Or run
docker-compose down
in a new terminal window.
- Press
-
Run tests on the Riki system:
docker-compose run riki test
This should generate coverage reports in the
reports/cov_html
folder. -
Generate documentation about the Riki system:
docker-compose run riki docs
This should generate documentation in the
reports/docs/wiki
folder. After running the Docker image, you can access the documentation at:http://localhost:5001/static/docs/wiki/index.html
-
Run in debug mode:
docker-compose run riki debug
This will run the program with a debugger.
-
Open a terminal in the running system:
docker-compose run riki bash
In general, any bash command can be run on the Riki system with:
docker-compose run riki <command>
Note: All predefined commands are in the Riki/entrypoint.sh
file. Examine that file for further information.