# Local testing using Docker ## Build ```docker compose build``` ## Start application You will need to provide credentials for Jira. The default user name is ```githubbot```. This can be overridden if you don't have its password. In any case, you must provide the password. ``` export REPORTER_JIRA_USER=username export REPORTER_JIRA_PASSWORD=password docker compose up ``` Alternatively, you can create the file `.env`, with contents: ```shell # if required: REPORTER_JIRA_USER=username REPORTER_JIRA_PASSWORD=password ``` The `.env` file should not be readable outside the logged in user. e.g. use `chmod 600 .env` on macOS/Linux Also be careful that it does not get added to any repository. Browse to ```http://localhost/:81``` You will be prompted to login. The credentials are not validated initially, but if they are incorrect, then no data will be displayed. To change your login details, close the browser and try again. Webserver logs will appear under ```docker-data/logs``` Gunicorn output to stdout ## Start shell in running container ```docker compose exec reporter bash``` ## Start container with shell instead of webserver ```docker compose run -rm -P reporter bash``` To start the app: [Remember to provide the jira credentials!] ``` export REPORTER_JIRA_USER=username export REPORTER_JIRA_PASSWORD=password docker-config/start-reporter.sh ``` ## stop the container and remove it ```docker container down```