> ## Documentation Index
> Fetch the complete documentation index at: https://docs.regatta.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# User Setup

The Regatta cluster requires a dedicated user on each of the servers participating in the cluster. The Regatta user must be defined as follows:

1. Username: `regatta`
2. Permissions: ownership of the block storage devices on the server

The Regatta installation (RPMs) will create a user named `regatta` upon deployment. Deciding which storage devices will be designated for the database does require manual action by the system administrator.

## User creation

If you would like to create the `regatta` user on all servers manually prior to installation, you may do so. In this case, the Regatta RPM will use the Regatta user created by you.

To create a Regatta user with device access, run the following command:

For example:

```shellscript theme={null}
sudo useradd -m -d /home/regatta -s /bin/bash regatta
```

Verify that the user was created successfully:

```shellscript theme={null}
getent passwd regatta
```

## Storage permission

A system administrator (or any user with `sudo` permission) will be required to perform the `chown` command on the storage devices dedicated to the Regatta database to grant the `regatta` user read and write access to these drives.

For example:

```shellscript theme={null}
sudo chown regatta:regatta /dev/<device> # for example: /dev/nvme0n1
```

<Note>
  The devices dedicated to the Regatta database do not require any filesystem. Regatta works optimally by utilizing raw devices.
</Note>