# rpk connect test

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt)

---
title: rpk connect test
latest-redpanda-tag: v26.2.1
latest-console-tag: v3.9.0
latest-operator-version: v26.2.1
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "false"
page-eol-date: July 28, 2027
latest-connect-version: 4.104.0
docname: rpk/rpk-connect/rpk-connect-test
page-component-name: streaming
page-version: "26.2"
page-component-version: "26.2"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-connect/rpk-connect-test.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/main/modules/reference/pages/rpk/rpk-connect/rpk-connect-test.adoc
description: Run unit tests defined in Redpanda Connect configuration files to verify pipeline behavior. If one or more tests fail, the command reports the errors and exits with status code 1.
page-git-created-date: "2024-05-30"
page-git-modified-date: "2026-08-03"
support-status: supported
---

<!-- Source: https://docs.redpanda.com/streaming/current/reference/rpk/rpk-connect/rpk-connect-test.md -->

Run unit tests defined in Redpanda Connect configuration files to verify pipeline behavior.

If one or more tests fail, the command reports the errors and exits with status code 1.

## [](#usage)Usage

```bash
rpk connect test [flags]
```

## [](#examples)Examples

This section provides examples of how to use `rpk connect test`.

Example.

```bash
rpk connect test ./path/to/configs/...
```

Example.

```bash
rpk connect test ./foo_configs/*.yaml ./bar_configs/*.yaml
```

Example.

```bash
rpk connect test ./foo.yaml
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --log | string | allow components to write logs at a provided level to stdout. |
| -v, --verbose | bool | print all test case names before they are executed. |
| -r, --resources | strings | pull in extra resources from a file, which can be referenced the same as resources defined in the main config, supports glob patterns (requires quotes). |
| -e, --env-file | strings | import environment variables from a dotenv file. |
| -t, --templates | strings | EXPERIMENTAL: import Redpanda Connect templates, supports glob patterns (requires quotes). |

## [](#global-flags)Global flags

| Value | Type | Description |
| --- | --- | --- |
| --config | string | Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings; -X help for detail or -X list for terser detail. |
| --ignore-profile | bool | Ignore rpk.yaml and redpanda.yaml; use default settings. |
| --profile | string | rpk profile to use. |
| -v, --verbose | bool | Enable verbose logging. |

## [](#suggested-reading)Suggested reading

-   [Unit Testing](https://docs.redpanda.com/connect/configuration/unit_testing/)