View Categories

TrueNAS S3 Service

How to Connect PeaSoup S3 to TrueNAS S3 Service #

Follow these steps to configure TrueNAS to store data on PeaSoup S3 using TrueNAS’s built-in S3 service, which supports integration with S3-compatible object storage like PeaSoup.

Prerequisites #

  • PeaSoup S3 Access: Ensure you have the following information:
    • Access key
    • Secret key
    • Bucket name
    • PeaSoup S3 endpoint URL (e.g., https://s3.pscloud.io)
  • TrueNAS Core/Enterprise installed and running, with administrative access to the system.

Steps to Connect PeaSoup S3 to TrueNAS S3 Service #

  1. Log into TrueNAS:
    • Access the TrueNAS web interface by navigating to your TrueNAS IP or DNS name in a web browser.
  2. Enable the S3 Service:
    • From the main dashboard, go to Services in the sidebar.
    • Locate the S3 service and switch it to On.
    • Click on the Configure button next to the S3 service to enter the configuration menu.
  3. Configure the S3 Service for PeaSoup:
    • Bind Address: Set the IP address that TrueNAS will use to communicate with PeaSoup S3 (typically the NAS IP).
    • Access Key: Enter your PeaSoup S3 access key.
    • Secret Key: Enter your PeaSoup S3 secret key.
    • Storage Path: Specify a directory on your TrueNAS system where the S3 data will be stored locally (if applicable).
    • Region: If needed, specify the region. Otherwise, leave this field blank.
    • Endpoint URL: Enter the PeaSoup S3 endpoint (e.g., https://s3.pscloud.io).
  4. Create and Configure Buckets:
    • Once the S3 service is running, you can create buckets by using the TrueNAS GUI or S3-compatible tools like the AWS CLI.
    • Specify the bucket name to match the PeaSoup S3 bucket where your data will be stored.
  5. Test the S3 Service:
    • After configuring the settings, click Save to apply the changes.
    • Use the TrueNAS S3 API, an S3-compatible client, or a CLI tool like AWS CLI to verify connectivity and ensure that the S3 service is correctly configured to communicate with PeaSoup S3.
  6. Use the S3 Service:
    • Once the connection is verified, you can start using TrueNAS to store and retrieve objects in PeaSoup S3 using S3-compatible tools.

Notes #

  • Ensure PeaSoup S3 is accessible from your TrueNAS system and that firewall rules allow communication between the two services.
  • TrueNAS’s S3 service enables S3-compatible object storage on your local NAS, which can be extended to external S3 services like PeaSoup.