# Jenkins

### How to integrate Meterian with a Jenkins task

The integration of Meterian with a Jenkins task is very simple and it requires just a couple of steps:

* First of all set METERIAN\_API\_TOKEN as environment variable. Environment variable can be set on Configure System from Manage Jenkins.

{% hint style="info" %}
To retrieve a Meterian API Token visit the [Meterian Dashboard](https://www.meterian.com/account); in your account select the tab "Tokens" and create a new one, or use an existing one.

API tokens are available only on paid account. To upgrade your subscription, please [contact us](mailto:support@meterian.io).
{% endhint %}

* On the main build task simply add an extra step, selecting 'Execute shell' from the dropdown menu

![](https://3502151236-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M-naNCUtT6Gw1tfDjRR%2F-M0biQpYe7kL2Vjiy-1w%2F-M0cL5hwDIwmB0i2QAkk%2Fimage.png?alt=media\&token=f97b5f00-a992-4c2a-bcc9-61f25ec00264)

And copy/paste this code snippet

```
docker run --rm \
--volume $(pwd):/workspace --env METERIAN_API_TOKEN=$METERIAN_API_TOKEN \
meterian/cli [Meterian CLI Options]
```

Learn more about the Meterian Client [here](https://docs.meterian.io/the-client/client).

### How does it work

Jenkins docker will download and set the Meterian container, which contains the latest version of the Meterian client and the building tools for all the supported languages, then Meterian will be launched against the project.

Finally, given the result of the scan, the Jenkins task will pass or it will fail.

### Using the Thin client

You can of course also the Thin Java client on Jenkins, which you can download as part of the or  offline. In order for the client to authenticate, as Jenkins is a headless server, please make sure that the METERIAN\_API\_TOKEN variable is loaded or that you are using a valid authorization file (see the "[How does the client authenticate me](https://docs.meterian.io/the-client/client/client-auth)" section).

```
curl -s "https://www.meterian.io/downloads/meterian-cli.jar" -o /tmp/meterian-cli.jar
java -jar /tmp/meterian-cli.jar
```