# ssh

## Syntax

```
ssh [<user>@]<host> [<command>]
```

## Syntax Description

<table><thead><tr><th width="203">Keyword</th><th>Description</th></tr></thead><tbody><tr><td>user</td><td>(Optional) The user name to use on the remote host.</td></tr><tr><td>host</td><td>The name or IP address of the remote host.</td></tr><tr><td>command</td><td>(Optional) A command to run on the remote host.</td></tr></tbody></table>

## Defaults

The default user name is "admin".

## Usage Guidelines

This commands establishes a Secure Shell (SSH) session to a remote host. Both public key and password authentication are supported. Public key authentication is attempted using the local ssh client key. If public key authentication fails, password authentication is used.

The ssh client maintains a list of public keys for the hosts that have been previous contacted. If the key received from the remote host does not match the stored key, the connection is aborted. Stored host keys can be edited with the [configure known-hosts](https://docs.islandrouter.com/island-router-cli-2.3.2/commands/configure-known-hosts) command or deleted with the [clear ssh known-hosts](https://docs.islandrouter.com/island-router-cli-2.3.2/commands/clear-ssh-known-hosts) command.

If command is given, the specified string is passed to the remote system for execution instead of invoking a login shell.

## Examples

```
ssh jane@server.example.com
```

## Related Commands

{% content-ref url="clear-ssh-client-keys" %}
[clear-ssh-client-keys](https://docs.islandrouter.com/island-router-cli-2.3.2/commands/clear-ssh-client-keys)
{% endcontent-ref %}

{% content-ref url="configure-known-hosts" %}
[configure-known-hosts](https://docs.islandrouter.com/island-router-cli-2.3.2/commands/configure-known-hosts)
{% endcontent-ref %}

{% content-ref url="show-config-known-hosts" %}
[show-config-known-hosts](https://docs.islandrouter.com/island-router-cli-2.3.2/commands/show-config-known-hosts)
{% endcontent-ref %}

{% content-ref url="clear-ssh-known-hosts" %}
[clear-ssh-known-hosts](https://docs.islandrouter.com/island-router-cli-2.3.2/commands/clear-ssh-known-hosts)
{% endcontent-ref %}

{% content-ref url="clear-ssh-host-keys" %}
[clear-ssh-host-keys](https://docs.islandrouter.com/island-router-cli-2.3.2/commands/clear-ssh-host-keys)
{% endcontent-ref %}

{% content-ref url="telnet" %}
[telnet](https://docs.islandrouter.com/island-router-cli-2.3.2/commands/telnet)
{% endcontent-ref %}