Configure the Client Agent

This feature requires HCP Boundary or Boundary Enterprise

The default configuration included with the Boundary Client Agent upon installation will be suitable for most users. If you want to make changes to the configuration, the configuration file is located in the following directory:

/Library/Application Support/HashiCorp/Boundary/boundary-client-agent.hcl

Configuration settings

The configuration file contains the following fields:

alias_refresh_interval - Specifies how often to refresh the alias cache. The default value is 1 minute.
Example:
```
alias_refresh_interval="60s"
```
dns_request_timeout - Specifies for how long the Client Agent DNS request handling, including any recursion, is allowed to run before it is canceled.
Example:
```
dns_request_timeout="300s"
```
interface_to_use - Specifies the interface to use instead of the default.
Example:
```
interface_to_use="en1"
```

log_file - Specifies where to write the Boundary Client Agent log file to.

Example:

log_file="/Library/Application\ /Support/HashiCorp/Boundary/boundary-client-agent.log"

log_level - Specifies the verbosity of the Client Agent logs.
Example:
```
log_level="DEBUG"
```
log_to_stdout - Logs to STDOUT in addition to the boundary-client-agent.log file.
Example:
```
log_to_stdout=false
```
override_upstream_dns_servers - Lists the DNS servers that should be used for recursing non-Boundary requests, overriding those configured on the system.
Example:
```
override_upstream_dns_servers = ["8.8.8.8", "8.8.4.4"]
```
state_file - Specifies where to write the Boundary Client Agent state file to. This is an ephemeral file which is removed on successful shutdown.
Example:
```
state_file="/Library/Application\ /Support/HashiCorp/Boundary/boundary-client-agent-state.json"
```
v4_prefix - Specifies an alternate prefix to use for generating IPs. Currently must be between /8 and /16
Example:
```
v4_prefix=1.1.1.1/8
```

Change the configuration

Complete the following steps to change the configuration of the Client Agent:

As a privileged user, open the Boundary Client Agent configuration file in the editor of your choice. By default, it is located in the following directory:
/Library/Application Support/HashiCorp/Boundary/boundary-client-agent.hcl
Change the configuration settings, and save the file.
Note
You must restart the Client Agent to update some configuration settings. However, when you restart the Client Agent, it closes any existing sessions. Other configuration settings can be updated by only reloading the configuration file, which does not affect any existing sessions.
Either reload the configuration file or restart the Client Agent.
You can change the following configuration values by reloading the configuration file, which will not disrupt any existing sessions:
Run the following command to reload the configuration file:
```
$ sudo pkill -1 boundary-client-agent
```
If you want to update another configuration value, you can restart the Client Agent using the following commands, however it will close any existing sessions:
```
$ sudo launchctl stop com.hashicorp.boundary.boundary-client-agent
$ sudo launchctl start com.hashicorp.boundary.boundary-client-agent
```

As a privileged user, open the Boundary Client Agent configuration file in the editor of your choice. By default, it is located in the following directory:
C:\Program Files\Hashicorp Boundary\boundary-client-agent.hcl
Change the configuration settings, and save the file.
Run the following commands to restart the Client Agent.
```
net stop BoundaryClientAgent
net start BoundaryClientAgent
```
Note that when you restart the Client Agent, it closes any existing sessions.