Proxy settings
Dev Proxy comes with several settings that you can use to control how the proxy should run.
You can configure these settings by setting them in the devproxyrc.json file, located in the proxy installation folder, or by setting them at run time through command line options.
The following table describes the settings.
Setting | Description | Command-line option | Allowed values | Default value |
---|---|---|---|---|
apiPort |
The port for the Dev Proxy API to listen on | n/a | integer | 8897 |
asSystemProxy |
Whether to register Dev Proxy as the system proxy on startup. When set to true requires installCert to be, set to true |
--as-system-proxy |
true , false |
true |
filterByHeaders |
Only intercept requests with specific headers | n/a | {"filterByHeaders": [ { "name": "value" } ] } . Value can be empty to include requests with the specified header no matter its value. |
n/a |
installCert |
Whether to install the root certificate | --install-cert |
true , false |
true |
ipAddress |
The IP address for the proxy to bind to | --ip-address <ipAddress> |
IPv4 address | 127.0.0.1 |
languageModel |
Settings for the language model | n/a | See the language model section for more information. | n/a |
logLevel |
Level of messages to log | --log-level <loglevel> |
trace , debug , information , warning , error |
information |
newVersionNotification |
Whether to notify about new versions | n/a | none , stable , beta |
stable |
n/a | Skip the first run experience (don't trust certificate on macOS) | --no-first-run |
n/a | n/a |
port |
The port for the proxy server to listen on | -p, --port <port> |
integer | 8000 |
rate |
The percentage of chance that proxy fails a request. Set to 0 to pass all requests to APIs, and to 100 to fail all requests. |
-f, --failure-rate <failurerate> |
0..100 |
50 |
record |
Use this option to record all request logs | --record |
n/a | n/a |
showSkipMessages |
Whether to show log messages when Dev Proxy skips running a plugin. | n/a | true , false |
true |
urlsToWatch |
List of URLs that proxy should intercept | -u, --urls-to-watch <urlsToWatch> |
Absolute URL (can contain wildcards) for example, "https://api.contoso.com/*" |
See devproxyrc file |
n/a | The IDs of processes to watch for requests | --watch-pids <pids> |
integer | n/a |
n/a | The names of processes to watch for requests | --watch-process-names <processNames> |
string | n/a |
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
Dev Proxy feedback
Dev Proxy is an open source project. Select a link to provide feedback: