Skip to content

Document console runner --configfile option for custom app config #1177

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
SeanKilleen merged 3 commits into from
May 15, 2026
Merged

Document console runner --configfile option for custom app config #1177

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
86a8074
Add --configfile option for custom app config
stevenaw May 15, 2026
048a1f0
Update Configuration-Files.md with custom config file info
stevenaw May 15, 2026
6635bd9
Fix linting
stevenaw May 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/articles/nunit/running-tests/Console-Command-Line.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ beginning with 2.0. Without the V2 driver, only version 3.0 and higher tests may
|`--testparam:PARAMETER, --tp:PARAMETER` | A test PARAMETER specified in the form NAME=VALUE for consumption by tests. Multiple parameters must be specified separated using a `--testparam` or `--tp` option for each. |
|`--params=PARAMETER, --p=PARAMETER` | (**NOTE:** _this is deprecated and will be removed in a future release. Please use --testparam instead_.) A test PARAMETER specified in the form NAME=VALUE for consumption by tests. Multiple parameters may be specified, separated by semicolons or by repeating the --params option multiple times. Case-sensitive. |
|`--config=NAME` | NAME of a project configuration to load (e.g.: Debug). |
|`--configfile=/path/to/custom.app.config` | Location to load an application configuration file from if outside dll directory. (_Console Runner 3.8+_) |
|`--process=PROCESS` | PROCESS isolation for test assemblies. Values: Single, Separate, Multiple. If not specified, defaults to Separate for a single assembly or Multiple for more than one. By default, processes are run in parallel. |
|`--inprocess` | This option is a synonym for --process=Single |
|`--agents=NUMBER` | NUMBER of agents that may be allowed to run simultaneously assuming you are not running inprocess. If not specified, all agent processes run tests at the same time, whatever the number of assemblies. This setting is used to control running your assemblies in parallel. |
Expand Down
6 changes: 5 additions & 1 deletion docs/articles/nunit/technical-notes/usage/Configuration-Files.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,5 +14,9 @@ be named nunit.tests.dll.config and located in the same directory as the dll.
1. When multiple assemblies are specified in an NUnit project (file extension `.nunit`),
it is possible to specify a common config file for the included test assemblies.

2. When multiple assemblies are specified on the command-line using the `--domain:Single`
2. A custom path to a configuration file can be specified on the command line using the
`--configfile=/path/to/custom.app.config` option if using version 3.8 or higher of the
console runner.

3. When multiple assemblies are specified on the command-line using the `--domain:Single`
option, no config file is currently used.
Loading