---
title: "Setup"
description: "Learn how to install and run the open-source version of the walt.id verifier API."
stack: "Community Stack (open source) — version 0.21.0"
stack_version: "0.21.0"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/community-stack/verifier/setup
generated: 2026-07-20
---
# Setup

## Installation & Running the Project

Make sure you have Docker installed on your machine.

### Option 1: Using Docker Pull

**1. Cloning The Identity-Repo**

First, clone the repository to your local machine:

```bash
git clone https://github.com/walt-id/waltid-identity.git && cd waltid-identity
```

**2. Pulling the Docker Image**

To quickly get started, you can pull the pre-built Docker image from Docker Hub:

```bash
docker pull waltid/verifier-api
```
**2. Running the Docker Image**

Once the image is pulled, you can run it using the following command:

```bash
docker run -p 7003:7003 \
  -itv $(pwd)/waltid-services/waltid-verifier-api/config:/waltid-verifier-api/config \
  -t waltid/verifier-api
```

### Option 2: Building the Image Yourself

**1. Cloning The Identity-Repo**

First, clone the repository to your local machine:

```bash
git clone https://github.com/walt-id/waltid-identity.git && cd waltid-identity
```

**2. Building the Docker Image**
If you prefer to build the Docker image yourself, use the Gradle Ktor/Jib tasks:

```bash
# Development (local Docker daemon, single-arch)
./gradlew :waltid-services:waltid-verifier-api:publishImageToLocalRegistry
# image: waltid/verifier-api:<version>
```

```bash
# Production (multi-arch push to your registry)
export DOCKER_USERNAME=<your-dockerhub-namespace>
export DOCKER_PASSWORD=<your-dockerhub-token>
./gradlew :waltid-services:waltid-verifier-api:publishImage
# image: docker.io/<DOCKER_USERNAME>/verifier-api:<version>
```

Note: multi-arch images require a registry push. Local tar output is single-arch only.

**3. Running the Docker Image**
After building the image, run it using (adjust the image name if you pushed to your registry):

```bash
docker run -p 7003:7003 \
  -itv $(pwd)/waltid-services/waltid-verifier-api/config:/waltid-verifier-api/config \
  -t waltid/verifier-api
```

## Start Verifying Credentials

Now that the verifier api is running, you can start verifying credentials.

- [How to Verify a W3C Verifiable Credential (JWT / SD-JWT) via OID4VP](https://docs.walt.id/community-stack/verifier/credential-verification/vc-oid4vc.md)
- [How to Verify an SD-JWT-based Verifiable Credential (IETF | SD-JWT VC) via OID4VP](https://docs.walt.id/community-stack/verifier/credential-verification/sd-jwt-vc-oid4vc.md)
- [How to Verify Mobile Driver’s Licenses (ISO/IEC 18013-5 mDL) via OID4VP](https://docs.walt.id/community-stack/verifier/credential-verification/mdl-oid4vc.md)
- [Full API reference](http://localhost:7003)