> 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

You can mount your File Storage on a GNU/Linux computer and work with the files from the system itself. You only need two details 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 start

* Access the administration panel at [admin.plenit.com](https://admin.plenit.com) with permissions on the service.
* Have an active **File Storage** subscription. If you don’t have it yet, set it up with the [File Storage Quick Start.](/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 enter the subscription. Open the **Users**, locate the user you will connect with, open their menu **(...)** menu **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**.

{/\* 📸 CAPTURE 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 tab **Customization** and, in the **SMB**block, copy the **URL** access. That is the address of the resource you will mount.

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

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

When you finish these two steps, you must have: the **user** access data for GNU/Linux and the **SMB address** of the resource.

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

With the two details, 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 you for the **password** of the user.

### Step 4. Check that access works

If the connection completes, you will be able to list the contents of the mounted resource:

```shell
ls
```

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

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

![SMB connection mounted and verified 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 in the section **Access details** for GNU/Linux (not the one for another system), that the address is the one in the block **SMB** from Customization, and that the password is that of the user you are connecting with.&#x20;
>
> If the `ls` does not show what you expected, get the data again from Steps 1 and 2.

### Conclusion

Accessing via SMB from GNU/Linux is a matter of combining two details 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 files in the repository like with 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 worth checking.

### Next steps

* Review the ways to access the service in [Access and sharing.](/docs-en/productos/file-storage/concepts/access-and-sharing.md)
* Organize permissions by users and groups in [Users, groups, and permissions.](/docs-en/productos/file-storage/concepts/users-groups-and-permissions.md)
* Customize the domain and service branding in [Customization.](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
