TrueNAS - iX Systems
Introduction
TrueNAS is a network attached storage (NAS) solution that allows for an off-site backup with cloud storage, such as Storj, to provide simplicity, speed, and durability in data storage.
Advantages of Storj with TrueNAS
Using Storj with TrueNAS provides resilient cloud object storage with blazing performance and zero-trust security. This integration ensures:
- Data durability: Use Storj as an offsite backup for your TrueNAS storage for multi-region durability.
Speed and simplicity of on-site storage with the added protection of a back-up in the cloud.
- it is also configurable in a variety of ways.
This integration uses S3 credentials passed from Storj to TrueNAS. You will need to set up a Storj account, create a Storj bucket for TrueNAS, and generate S3 credentials for TrueNAS. Then, you will need to create a Cloud Credential on TrueNAS that will grant it access to the bucket in Storj.
Software Requirements
Storj if fully integrated with TrueNAS.
To integrate TrueNAS with Storj, you will need:
- A Storj account
- A TrueNAS storage device connected to your network.
For more information about the iX Storj integration, see the press release.
Navigate to https://ix.storj.io to sign up iX-Storj account. Enter your full name, email address, and a password, as shown below:
If you have an existing Storj account, you will need to contact support to have it linked to the iX Storj integration. See here for more information

Create a Bucket
Once you have your Storj account, create a Storj bucket for TrueNAS following the steps below. This is the bucket that the TrueNAS will access.
1. Navigate to “Buckets” on the left side menu.
2. Click “New Bucket” on the top right.

3. Select “Continue”.
4. Generate a passphrase or enter your own.

5. Select “Continue”.
6. Record the passphrase somewhere safe.
Remember your passphrase as you will need it for future access of your data. Storj is unable to recover your passphrase for you.
You will need to generate S3 credentials for TrueNAS to access your bucket in Storj. S3 credentials consist of an access key, secret key, and endpoint. You will need to store them somewhere safe, as they cannot be recovered.
Create S3 credentials in the Storj web console:
- Navigate to “Access” on the left side menu
- Click “Create S3 Credentials” under the S3 Credentials block.

3. When the Create Access screen comes up, set specifications according to the following guidelines:
- Type: S3 Credentials
- Name: The name of the credentials (e.g. trueNAS)
- Permissions: All
- Buckets: Feel free to specify the bucket you created above (e.g. truenas), or leave as “All”

4. Check the "Encryption Information" pop-up message that says, "By generating S3 credentials, you are opting in to server-side encryption". The click "Continue".

5. Select your passphrase encryption from either the "Generate Passphrase" or "Create My Own Passphrase" options. This is the passphrase used to access the files in your bucket.
6. You can then click one of the "Copy to Clipboard" or "Download .txt" options.

7. Check the message to acknowledge that you have read it: "I understand that Storj does not know or store my encryption passphrase. If I lose it, I won't be able to recover files."
8. Click the "Create My Access" button.

9. Your S3 credentials are created. Write them down and store them, or click the "Download .txt" button. You will need these credentials for the following steps.

To complete the integration, you will need the S3 credentials created in the previous steps and a TrueNAS login.
1. Log into TrueNAS on your network.

2. On the left-hand menu, navigate to "Credentials" and select "Backup credentials".

3. Click "Add" under the Cloud Credentials section.

4. On the right-hand pop-up menu, complete the fields as follows:
- Name: the name of your credential, e.g. Storj.
- Provider: select Storj iX from the drop-down.
- Access Key ID: the access key from your S3 credentials created in Storj.
- Secret Access Key: the secret key from your S3 credentials created in Storj.


5. Click "Verify" to very the credentials if you wish.
6. Click "Save".
1. On the left-hand menu, click "Data Protection", navigate to Cloud Sync Tasks, and click "Add".

2. In the Add Cloud Sync Task window, fill out the fields as follows:
- Description: your preferred description, e.g. "Daily".
- Direction: PUSH. This transfers data from TrueNAS to the cloud.
- Transfer Mode: Copy
- Credential: Choose the Storj credential from the drop-down.
- Bucket: choose the truenas bucket you created within Storj.
- Folder (optional): The path where the data should be stored within the bucket.
- Directory/Files: the folder in your directory to push from.
3. Click "Save". Under Cloud Sync Tasks you should see an entry for the "Daily" task, along with a green SUCCESS tag.

4. To test whether the sync has been successful, click the "Run Now" arrow in the task entry.

While the tasks is running, an orange "RUNNING" label will appear in the task entry. Once the task completes, it will return to a green "SUCCESS" tag.
You can now check on the file sync. The TrueNAS bucket in Storj should contain the contens of the folder you had uploaded.