website logo
Create accountLogin
Home
DCS
Node
Resources
Help center
Navigate through spaces
Home
DCS
Node
Resources
Help center
⌘K
Storj DCS
Get Started
AWS CLI and Hosted Gateway MT
AWS SDK and Hosted Gateway MT
Uplink CLI
Satellite Admin Console
Object Browser
Downloads
Download Uplink CLI
Download Self-hosted S3 Compatible Gateway
Download Storj Client Libraries
SDKs & Reference
Tutorial
How-to Guides
Concepts
Support
Support Overview
FAQ
Community Forum
Status Page
Help Desk
Billing, Payment & Accounts
Resources
Moved Documents
Docs powered by archbee 
33min

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:

  1. Data durability: Use Storj as an offsite backup for your TrueNAS storage for multi-region durability.
  2. Speed and simplicity of on-site storage with the added protection of a back-up in the cloud.

  3. it is also configurable in a variety of ways.

Integration

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.

Setting up Storj

Sign up for an account

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

Document image

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.

Document image

3. Select “Continue”.

4. Generate a passphrase or enter your own.

Document image

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.

Generate S3 credentials

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:

  1. Navigate to “Access” on the left side menu
  2. Click “Create S3 Credentials” under the S3 Credentials block.
Document image

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”
Document image

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".

Document image

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.



Document image

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.

Document image

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.

Document image

Integrating TrueNAS with Storj

To complete the integration, you will need the S3 credentials created in the previous steps and a TrueNAS login.

Create a Cloud Credential in TrueNAS

1. Log into TrueNAS on your network.

Document image

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

Document image

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

Document image

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.
Document image
Document image

5. Click "Verify" to very the credentials if you wish.

6. Click "Save".

Create a Cloud Sync Task

1. On the left-hand menu, click "Data Protection", navigate to Cloud Sync Tasks, and click "Add".

Document image

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.

Document image

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

Document image

Success!

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.

Updated 19 Jan 2023
Did this page help you?
Yes
No
UP NEXT
Unitrends
Docs powered by archbee 
TABLE OF CONTENTS
Introduction 
Advantages of Storj with TrueNAS 
Integration
Software Requirements 
Setting up Storj
Sign up for an account
Create a Bucket 
Generate S3 credentials
Integrating TrueNAS with Storj
Create a Cloud Credential in TrueNAS
Create a Cloud Sync Task
Success!