# General usage

### How to use

#### Installation

Download the `isaac` script from here [here](https://github.com/MeterianHQ/isaac-scanner/blob/main/isaac) and make it executable. A later invocation of the script will ensure, through Docker, that the scanner image [`meterian/isaac:latest`](https://hub.docker.com/r/meterian/cs-engine) is pulled. Subsequent invocations of the script will not ensure this, so newer versions of the image can be accessed through docker pull.

#### Operation

The scanner is fully integrated with the [Meterian Dashboard](https://www.meterian.com/dashboard/): every scan will be recorded and managed there.

#### Executing a scan

You can perform a scan by simply moving in the folder where the IAC code is and run the script:

```
$ isaac 
```

Note that to perform a scan a valid Meterian API token must be set as environment variable on your system. To gain a token, create one from your account at <https://meterian.com/account/#tokens>

Once you have a token populate a `METERIAN_API_TOKEN` environment variable with its value as shown below

```bash
export METERIAN_API_TOKEN=12345678-90ab-cdef-1234-567890abcdef
```