# Local testing using Docker

## Build

```docker compose build```

## Start application

You will need to provide a token for Jira.

```
export REPORTER_JIRA_TOKEN=token
docker compose up
```

Alternatively, you can create the file `.env`, with contents:

```shell
# if required:
REPORTER_JIRA_TOKEN=token
```

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/```

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_TOKEN=token
docker-config/start-reporter.sh
```

## stop the container and remove it

```docker compose down```