> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-en/productos/file-storage/how-to/how-to-access-smb-from-linux.md).

# How to Access SMB from GNU/Linux Systems

Connect your File Storage from a GNU/Linux system using the user's SMB data, mounting the share from the terminal.

You can mount your File Storage on a GNU/Linux computer and work with the files from the system itself. You only need two pieces of data from the panel — the SMB user for Linux and the SMB address — and a command in the terminal.

This guide walks you through both.

> 👍 What you get
>
> The File Storage repository mounted on your GNU/Linux system via SMB, ready to work with its files from the terminal.

### Before you begin

* Access the administration panel at [admin.plenit.com](https://admin.plenit.com) with permissions on the service.
* Have a subscription of **File Storage** active. If you don't have it yet, set it up with the [Quick Start for File Storage.](https://docs.plenit.com/docs-en/productos/file-storage/quickstart.md)

### Step 1. Copy the SMB user for GNU/Linux

In [admin.plenit.com](https://admin.plenit.com), go to **Cloud Services → File Storage** and open the subscription. Open the **Users**, find the user you are going to connect with, open their menu **(…)** and click **Access details**.

In that view you will see the connection details for several systems (Windows, GNU/Linux and Mac). Copy the **user** corresponding to **GNU/Linux**.

{/\* 📸 SCREENSHOT 1 · Users › menu (…) › Access data · highlight the GNU/Linux user \*/}

![Access data for the user with the GNU/Linux user](https://reemplaza-url/almacenamiento-archivos-smb-linux-01.png)

### Step 2. Copy the SMB address

Open the **Customization** and, in the block **SMB**, copy the **URL** for access. That is the address of the resource you will mount.

{/\* 📸 SCREENSHOT 2 · Customization › SMB block · highlight the URL field \*/}

![SMB address in the Customization tab](https://reemplaza-url/almacenamiento-archivos-smb-linux-02.png)

At the end of these two steps, you should have: the **user** login for GNU/Linux and the **SMB address** of the resource.

### Step 3. Mount the resource from the terminal

With the two pieces of data, launch the connection from the console with this format:

```shell
mount.cifs <smb_address> -o user=<user>
```

Replace `<smb_address>` for the SMB address you copied and `<user>` for the GNU/Linux user. When you run it, the system will ask for the **password** of the user.

### Step 4. Check that access works

If the connection completes, you can list the contents of the mounted resource:

```shell
ls
```

You should see the contents of the SMB repository you just connected to.

{/\* 📸 SCREENSHOT 3 · terminal · mounted connection and ls showing the contents \*/}

![Mounted and verified SMB connection from the terminal](https://reemplaza-url/almacenamiento-archivos-smb-linux-03.png)

> #### 🚧 If the connection does not complete
>
> Check these points before trying again: that the user is the one from the section **Access details** for GNU/Linux (not from another system), that the address is the one from the **SMB** Customization block, and that the password is that of the user you connect with.
>
> If the `ls` does not show what is expected, get the data again from Steps 1 and 2.

### Conclusion

Accessing via SMB from GNU/Linux is a matter of putting together two pieces of data from the panel — the Linux user from Access data and the SMB address from Customization — and mounting them with a command. Once mounted, you work with the repository files like any other system resource.

If something fails, it is almost always because of mixing up the user from another operating system or the address, so that is the first thing to check.

### Next steps

* Review the ways to access the service in [Access and sharing.](https://docs.plenit.com/docs-en/productos/file-storage/concepts/access-and-sharing.md)
* Organize permissions by users and groups in [Users, groups, and permissions.](https://docs.plenit.com/docs-en/productos/file-storage/concepts/users-groups-and-permissions.md)
* Customize the service's domain and brand in [Customization.](https://docs.plenit.com/docs-en/platform/organizations/detalles/customization.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.plenit.com/docs-en/productos/file-storage/how-to/how-to-access-smb-from-linux.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
