Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
bc11936
PD-2218 Update Replication UI Ref
micjohnson777 Sep 26, 2025
c320b9c
PD-2218 Update Language about switching between screens
micjohnson777 Sep 26, 2025
7169313
PD-2218 Replication Updates
micjohnson777 Sep 29, 2025
143f805
PD-2218 Update UI ref and main replication tutorial index
micjohnson777 Sep 29, 2025
46e5c06
PD-2218 Create New Snippets Rewrite Remote Replication
micjohnson777 Sep 30, 2025
9cb85bb
PD-2218 Grammer, Spelling, and Content check
micjohnson777 Sep 30, 2025
953506c
PD-2218 Update Local Replication Tutorial
micjohnson777 Sep 30, 2025
64df63d
PD-2218 Save changes not in previous commit
micjohnson777 Sep 30, 2025
e2cbdab
PD-2218 Saves changes in Remote Replication not in the two previous c…
micjohnson777 Sep 30, 2025
4f9503d
PD-2218 Update Advanced Replication
micjohnson777 Sep 30, 2025
f017586
PD-2218 Update the ReplicationWithEncryptionSCALE.md Tutorial
micjohnson777 Sep 30, 2025
04343c2
Merge branch 'master' into PD-2218-Update-Replication-Task-Content
micjohnson777 Sep 30, 2025
7bdc269
PD-2218 Update the AddSSHConnection.md snippet
micjohnson777 Oct 2, 2025
5d690d6
Merge branch 'master' into PD-2265-Update-Rsync-UI-ref-and-Tutorial-C…
micjohnson777 Oct 2, 2025
32d7ff4
Merge branch 'PD-2218-Update-Replication-Task-Content' into PD-2265-U…
micjohnson777 Oct 2, 2025
e13e63e
PD-2265 Update Branch and Update the Rsync task and SSH Connection c…
micjohnson777 Oct 2, 2025
0d57b73
PD-2265 Update the AddSSSHConnectionKeyPair.md tutorial
micjohnson777 Oct 2, 2025
d238c13
Update ReplicationScheduleAndRetentionSteps.md
linzi-ix Oct 7, 2025
a5e1cd3
Merge branch 'master' into PD-2265-Update-Rsync-UI-ref-and-Tutorial-C…
micjohnson777 Oct 9, 2025
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
Original file line number Diff line number Diff line change
Expand Up @@ -20,19 +20,18 @@ Using these widgets, users can establish Secure Socket Shell (SSH) connections.

You must also configure and activate the [SSH Service]({{< ref "sshservicescale" >}}) to allow SSH access.

These SSH credentials are used to manage SSH connections specifically for automated tasks such as replication, backups, cloud sync, or other system-to-system operations. You can generate, store, and manage SSH key pairs and define SSH connections that TrueNAS uses for these automated processes. The key pairs managed here are not tied to individual user logins, but are instead used by the system for secure communication with other systems or services.
These SSH credentials are used to manage SSH connections specifically for automated tasks such as replication, backups, cloud sync, or other system-to-system operations. You can generate, store, and manage SSH key pairs and define SSH connections that TrueNAS uses for these automated processes. The key pairs managed here are not tied to individual user but are instead used by the system for secure communication with other systems or services.

For individual user SSH access, configure SSH keys in the user account settings under **Credentials > Users**.

## Creating an SSH Connection

To begin setting up an SSH connection, go to **Credentials > Backup Credentials**.

{{< trueimage src="/images/SCALE/Credentials/BackupCredentialsScreen.png" alt="Backup Credentials Screen" id="Backup Credentials Screen" >}}

Click **Add** on the **SSH Connections** widget.
{{< include file="/static/includes/AddSSHConnection.md" >}}

### Configuring a Semi-Automatic SSH Connection

The procedure in this section covers the semi-automatic setup method for creating an SSH connection with another TrueNAS system.

**Semi-automatic** simplifies setting up an SSH connection with another TrueNAS system without logging in to that system to transfer SSH keys.
Expand All @@ -43,35 +42,36 @@ You can generate the key pair as part of the semiautomatic configuration or a ma
{{< include file="/static/includes/AddSSHConnection.md" >}}

### Configuring a Manual SSH Connection

The instructions in this section cover how to set up an SSH connection to a non-TrueNAS system.
To manually set up an SSH connection, you must copy a public encryption key from the local system to the remote system.
A manual setup allows a secure connection without a password prompt.

{{< include file="/static/includes/AddManualSSHConnection.md" >}}

### Adding a Public SSH Key to an Admin User Account

This procedure covers adding a public SSH key to the admin account on the TrueNAS system and generating a new SSH Keypair to add to the remote system (TrueNAS or other).

1. Copy the SSH public key text or download it to a text file:

Log into the TrueNAS system that generated the SSH key pair and go to **Credentials > Backup Credentials**.
Log in to the TrueNAS system that generated the SSH key pair and go to **Credentials > Backup Credentials**.

Click on the name of the key pair on the **SSH Keypairs** widget to open the key pair for the SSH connection.

Copy the text of the public SSH key or download the public key as a text file.

2. Add the public key to the admin account on the system where you want to register the public key.

Log into the TrueNAS system where you want to register the public key and go to **Credentials > Users**.
Log in to the TrueNAS system where you want to register the public key and go to **Credentials > Users**.

Edit the admin account.
Click on the <span class="material-icons">expand_more</span> icon and then click **Edit** to open the **Edit User** screen.
Edit the admin account. Select the user, and click **Edit** to open the **Edit User** screen.

{{< trueimage src="/images/SCALE/Credentials/SSHEditUserAuthenticationSettings.png" alt="Add SSH Key" id="Add SSH Key" >}}
{{< trueimage src="/images/SCALE/Credentials/EditUserFullAdminSSHAccess.png" alt="Adding SSH Settings" id="Adding SSH Settings" >}}

Paste the SSH public key text into the **Authorized Keys** field on the **Edit User** configuration screen in the **Authentication** settings.
Verify the user has **TrueNAS Access** selected and the full admin role selected, and the **SSH Access** selected to show the SSH authentication fields.

Alternately, click **Choose File** to select and upload the SSH key.
Paste the SSH public key text into the **Public SSH Key** field in the **Authentication** settings.

{{< hint type=important >}}
Do not paste the SSH private key.
Expand All @@ -81,9 +81,10 @@ This procedure covers adding a public SSH key to the admin account on the TrueNA

If you need to generate a new SSH key pair, see [Generating SSH Keypairs](#generating-ssh-keypairs).

If the remote NAS is not a TrueNAS system, refer to the documentation for that system, and find their instructions on adding a public SSH key.
If the remote NAS is not a TrueNAS system, refer to the documentation for that system and find its instructions on adding a public SSH key.

## Generating SSH Keypairs

TrueNAS generates and stores [RSA-encrypted](https://tools.ietf.org/html/rfc8017) SSH public and private key pairs on the **SSH Keypairs** widget found on the **Credentials > Backup Credentials** screen.
Key pairs are generally used when configuring **SSH Connections** or SFTP **Cloud Credentials**.
TrueNAS does not support encrypted key pairs or key pairs with passphrases.
Expand Down
Loading