> For the complete documentation index, see [llms.txt](https://docs.rhinofcp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rhinofcp.com/getting-started/quick-start-guide/mounting-storage-to-your-rhino-client.md).

# Mounting Storage to Your Rhino Client

## What is Mounting and Which Types of Storage are Supported?

"Mounting" is the process that an operating system follows to make files and directories in storage (such as a hard drive, network share, or a cloud-based bucket) easily accessible through a system's directory tree. Once mounted, you can easily access the items in the bucket or directory using a client mount path that starts with `/rhino_data`.

You can perform the mount process to the following types of storage:

* Amazon Web Services (AWS) S3 Bucket
* Google Cloud Platform's (GCP) Cloud Storage (CS) Bucket
* Azure Blob Storage (AZ)
* Server Message Block (SMB) network file sharing protocol directories

In addition to mounting storage, this article  explains how to:

* View mount storage configuration
* Test connection and access to the client-mounted storage
* Perform basic troubleshooting for connection and access problems
* How to unmount storage

## Prerequisites

Before you complete these steps, you should have:

* An AWS S3 Bucket, Google Cloud Bucket, Azure Blob container, or an SMB directory already created
* Credentials to connect to the bucket or directory
* Read or Read-Write access for the bucket or directory you want to mount

{% hint style="info" %}
NOTE:  We highly recommend that you verify your access credentials and permissions before completing the steps below.
{% endhint %}

## Mounting an AWS S3 Bucket

To mount an AWS S3 bucket, do the following.

{% stepper %}
{% step %}

#### Select Client Mounted Storage

Select the sprocket from the bottom left corner of the Rhino FCP main page, then select **Client Mounted Storage** from the Settings menu.

![](/files/6e3b6faef1eb4b45d4e70d64fe435e559781e806)
{% endstep %}

{% step %}

#### Open Mount Storage

In the **Client Mounted Storage** page, select the **Mount Storage** button from the upper right side of the page.

![](/files/eb566b33957e7cbe8d118281aab268dc4824b493)
{% endstep %}

{% step %}

#### Confirm the default type

The **Mount Storage** page opens. The **Type** field has AWS S3 chosen by default.

![](/files/847885ffba20ef2068e72b1f84aef60d41bd0555)
{% endstep %}

{% step %}

#### Enter bucket details

Enter the S3 bucket name in the **Bucket Name** field.

Enter a description. This is optional, but it can help you to remember details about the bucket in the future.

Indicate the path in the **Client Mount Path** field that includes the subfolder to access your cloud data within the Rhino Client (if needed), such as *my\_cloud\_storage\_folder*. The provided bucket will be mapped to the following path: */rhino\_data/external/file storage type/my\_cloud\_storage\_folder*.
{% endstep %}

{% step %}

#### Enter credentials and permissions

Next, indicate the credentials needed to access the AWS S3 bucket. Note that storage hosted in the same VPC as your Rhino Client might not require credentials. You have two choices:

* enter an access key if you've set one up
* access the AWS Profile

If you choose access key, enter the **Access Key ID** and the **Secret Access Key**. You can click the eye icon next to each field to see what you've entered.

Finally, indicate the access permissions by selecting the radio-button: **Read-write** or **Read-only**.
{% endstep %}

{% step %}

#### Create the mount

When finished, click **Create**. An entry appears that shows the **Client Mount Path**, **Access Permission**, and **Test Results**. If there is a problem, an error message will appear.

![](/files/3b008ffbce8e2a606a96f75b56905b71cf1453cd)
{% endstep %}
{% endstepper %}

## Mounting a Google Cloud Storage Bucket

To connect to the Google Cloud Storage bucket, do the following.

{% stepper %}
{% step %}

#### Select Client Mounted Storage

Select the sprocket from the bottom left corner of the Rhino FCP main page, then select **Client Mounted Storage** from the Settings menu.

![](/files/6e3b6faef1eb4b45d4e70d64fe435e559781e806)
{% endstep %}

{% step %}

#### Open Mount Storage

In the **Client Mounted Storage** page, select the **Mount Storage** button from the upper right side of the page.

![](/files/eb566b33957e7cbe8d118281aab268dc4824b493)
{% endstep %}

{% step %}

#### Confirm the default type

The **Mount Storage** page opens. The **Type** field has AWS S3 chosen by default.

![](/files/847885ffba20ef2068e72b1f84aef60d41bd0555)
{% endstep %}

{% step %}

#### Select Google Cloud Storage

Select **Google Cloud Storage** in the **Type** field.

![](/files/b68f7d13e60f977bd45d079993b320ccab5fcc13)
{% endstep %}

{% step %}

#### Enter bucket details

Enter the Google Cloud bucket name in the **Bucket Name** field.

Enter a description. This is optional, but it can help you to remember details about the bucket in the future.

Indicate the path in the **Client Mount Path** field that includes the subfolder to access your cloud data within the Rhino Client (if needed), such as *my\_cloud\_storage\_folder*. The provided bucket will be mapped to the following path: */rhino\_data/external/file storage type/my\_cloud\_storage\_folder*.
{% endstep %}

{% step %}

#### Enter credentials and permissions

Next, indicate the credentials that are needed to access the Google Cloud bucket. Note that storage hosted in the same VPC as your Rhino Client might not require credentials. You can click the eye icon next to the field to see what you've entered.

Finally, indicate the access permissions by selecting the radio-button: **Read-write** or **Read-only**.
{% endstep %}

{% step %}

#### Create the mount

When finished, click **Create**. An entry appears that shows the **Client Mount Path**, **Access Permission**, and **Test Results**.

![](/files/84452c3cc147b00e016ae581dcf083bd8622ad4f)
{% endstep %}
{% endstepper %}

## Mounting an Azure Blob Storage Container

To connect to the Azure Cloud Blob Storage container, do the following.

{% stepper %}
{% step %}

#### Open Client Mounted Storage

Select the sprocket icon from the bottom left corner of the Rhino FCP main page, then choose **Client Mounted Storage** from the Settings menu.
{% endstep %}

{% step %}

#### Open Mount Storage

Click **Mount Storage**.
{% endstep %}

{% step %}

#### Select Azure Blob Storage

Select **Azure Blob Storage** in the **Type** field.
{% endstep %}

{% step %}

#### Enter container and account details

Enter the **Container Name**.

Enter the **Storage Account Name**.

Optionally, enter a **Description**.
{% endstep %}

{% step %}

#### Enter mount path and credentials

Indicate the **Client Mount Path**.

Fill out the credentials details (**Account Name**, **Key**, **Resource Group**, and **Subscription ID**) if needed.
{% endstep %}

{% step %}

#### Set permissions and create the mount

Set **Read-write** or **Read-only** permissions.

Click **Create**. ![](/files/8c73ffc8bc96fe147421c07e98406a2552b858e7)

An entry appears showing **Client Mount Path**, **Access Permission**, and **Test Results**.

![](/files/ad11d62da611e6bcefe7768acf3d9347f28030e6)
{% endstep %}
{% endstepper %}

## Mounting an SMB Directory

To connect to an SMB directory, do the following.

{% stepper %}
{% step %}

#### Select Client Mounted Storage

Select the sprocket from the bottom left corner of the Rhino FCP main page, then select **Client Mounted Storage** from the Settings menu.

![](/files/6e3b6faef1eb4b45d4e70d64fe435e559781e806)
{% endstep %}

{% step %}

#### Open Mount Storage

In the **Client Mounted Storage** page, select the **Mount Storage** button from the upper right side of the page.

![](/files/eb566b33957e7cbe8d118281aab268dc4824b493)
{% endstep %}

{% step %}

#### Confirm the default type

The **Mount Storage** page opens. The **Type** field has AWS S3 chosen by default.

![](/files/847885ffba20ef2068e72b1f84aef60d41bd0555)
{% endstep %}

{% step %}

#### Select SMB

Select **SMB** in the **Type** field.

![](/files/287da43af9d445997ecfe57ed8fa3c706de557ba)
{% endstep %}

{% step %}

#### Enter SMB details

Enter the name of the SMB Host device.

Enter the shared folder path.

Enter a description. This is optional but can help you remember details about this storage option in the future.

Indicate the path in the **Client Mount Path** field that includes the subfolder to access your data within the Rhino Client (if needed), such as *my\_smb\_storage\_folder*. The provided bucket will be mapped to the following path in rhino\_data: */rhino\_data/external/file storage type/my\_smb\_storage\_folder*.
{% endstep %}

{% step %}

#### Enter credentials and permissions

Next, indicate the credentials if needed. Storage hosted in the same VPC as your Rhino Client might not require credentials. Enter the username and password in the text fields. You can click the eye icon next to the fields if you want to see what you've entered.

Finally, indicate the access permissions by selecting the radio-button: **Read-write** or **Read-only**.
{% endstep %}

{% step %}

#### Create the mount

When finished, click **Create**. An entry appears that shows the **Client Mount Path**, **Access Permission**, and **Test Results**. If there is a problem, an error message will appear.

![](/files/3b008ffbce8e2a606a96f75b56905b71cf1453cd)
{% endstep %}
{% endstepper %}

## Showing Configuration

To show the configuration for the client mount storage, do the following.

{% stepper %}
{% step %}

#### Open the entry menu

Select the three-dot menu on the right side of the entry.

![](/files/97dc19ab456585f2ec5eb99c7eefe6d058dcc13c)
{% endstep %}

{% step %}

#### Show the configuration

Select **Show Configuration** to show the Mount Storage Configuration page.

![](/files/1c0ee63373db9c0c68052948cc216e6e7fc9cb4f)
{% endstep %}
{% endstepper %}

## Testing Data Access

To test access to the client mount storage point, do the following.

{% stepper %}
{% step %}

#### Open the entry menu

Select the three-dot menu on the right side of the entry.

![](/files/97dc19ab456585f2ec5eb99c7eefe6d058dcc13c)
{% endstep %}

{% step %}

#### Test access

Select **Test Access** to start the test. The test results are updated. Results can be one of the following.
{% endstep %}
{% endstepper %}

* The green circle with a checkmark, as shown below, indicates that Rhino FCP can connect to the bucket or folder. It also indicates that it can access file data at the level of permission you indicated (either read or read-write).

  ![](/files/84452c3cc147b00e016ae581dcf083bd8622ad4f)
* The yellow circle with an exclamation mark, as shown below, indicates that Rhino FCP can connect to the bucket or folder. But, it cannot access that bucket or folder's file data at the level of permission you indicated (either read or read-write).

  ![](/files/41a14b044a65634890562ac96f0f07833e503a0d)
* The red circle with an exclamation mark, as shown below, indicates that Rhino FCP cannot connect to the bucket or folder.

  ![](/files/a173e71c22610daed93425f9d7489c5a1ae95645)

## Troubleshooting

Here are some steps for troubleshooting connection and permissions issues.

{% stepper %}
{% step %}

#### Check the configuration

Select the three-dot menu to the right, then select **Show Configuration**. Ensure that the bucket or folder name is correct. If it is incorrect, follow the instructions to unmount client storage then mount the bucket or directory again.
{% endstep %}

{% step %}

#### Test your credentials and permissions

Test your credentials. Using the credentials you entered in Rhino FCP, use another method to access the bucket or folder. For example, use Amazon CLI or the Amazon and the credentials that you provided to access an S3 bucket or use the Google Cloud Console or CLI and the credentials you provided to access a Google Cloud bucket.

* If you cannot connect, verify the credentials, then try to access it again.
* Next, check permissions. Try reading a file once you have connected, then if you want to write to mounted storage, try writing to a file.
  {% endstep %}

{% step %}

#### Mount again with updated configurations

Once you have successfully completed these steps, follow the instructions to mount the bucket or directory again, updating your configurations based on your findings in the first and second steps. Note that you will need to follow the instructions to unmount client storage. Then, you will need to mount the bucket or directory again.
{% endstep %}

{% step %}

#### Review other references

Other troubleshooting references are:

* Troubleshooting Google Cloud Platform, Google Cloud bucket connection issues:

  <https://cloud.google.com/storage/docs/troubleshooting>.
* Troubleshooting AWS S3 bucket connection issues:

  <https://docs.aws.amazon.com/AmazonS3/latest/userguide/troubleshoot-403-errors.html>.
* You can also contact Rhino Support for more help.
  {% endstep %}
  {% endstepper %}

## Unmounting Storage

To remove the mount to the storage, complete the following steps.

{% stepper %}
{% step %}

#### Open the entry menu

Select the three-dot menu on the right side of the entry.

![](/files/97dc19ab456585f2ec5eb99c7eefe6d058dcc13c)
{% endstep %}

{% step %}

#### Unmount storage

Select **Unmount** to remove the mount point for the storage.
{% endstep %}
{% endstepper %}