> For the complete documentation index, see [llms.txt](https://docs.meterian.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meterian.io/iac-scanner/general-usage.md).

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