# vpn peer host

## Syntax

```
[no] vpn peer <id> host <host>
```

## Syntax Description

<table><thead><tr><th width="203">Keyword</th><th>Description</th></tr></thead><tbody><tr><td><code>no</code></td><td>(Optional) Removes the peer host entry from the VPN.</td></tr><tr><td>id</td><td>The VPN identifier. Must be a number in the range 0-1022 or the keyword "auto".</td></tr><tr><td>host</td><td>The name or IP address of the VPN peer.</td></tr></tbody></table>

## Defaults

If this command is not specified for a given VPN, the Island will not intiate connections to the peer.

## Usage Guidelines

This command enables the Island to initiate connections to a VPN peer, and defines the name or IP address of the peer.

If a VPN exists with the specified identifier, the existing VPN will be modified; otherwise, a new VPN with the specified identifier will be created. If "auto" is specified for the identifier, a new VPN will be created using the next available identifier.

If this command is not specified for a given peer, the Island will not initiate a connection to the peer; the peer must initiate the connection to the Island.

## Examples

```
vpn peer 2 host vpn-server.example.net
```

## Related Commands