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

# Block Storage

> High-performance, persistent block storage for bare metal servers

Block Storage provides high-performance, persistent storage volumes that can be attached to bare metal servers on the Latitude.sh platform. It ensures data is retained independently of server lifecycle, making it ideal for workloads requiring flexible, portable data management.

Block Storage is optimized for fast access and seamless integration, offering a reliable way to manage data-intensive applications with the flexibility to attach and detach across different servers.

<Warning>
  New experience coming soon. Creation of new volumes is temporarily disabled.
</Warning>

<Note>
  Block Storage is currently in Preview. Features and capabilities may evolve
  based on customer feedback.
</Note>

<Note>
  Currently, it is not possible to change the size of existing volumes.
</Note>

### Creating Block Storage

<Steps>
  <Step title="Create volume">
    Log in to the Latitude.sh dashboard and navigate to **Storage** > **Block
    storage** in the sidebar. Click **Create volume**, specify the name and
    size, and click **Create**.
  </Step>
</Steps>

### Mounting a volume to a bare metal server

Block storage volumes can be mounted to your bare metal servers using the Latitude CLI (`lsh`). Follow the steps below:

<Steps>
  <Step title="Install the Latitude CLI">
    On your bare metal server, download and install the Latitude CLI:

    ```bash theme={null}
    curl -fsSL https://cli.latitude.sh/install.sh | sh
    ```
  </Step>

  <Step title="Authenticate the CLI">
    Authenticate using your API key. You can generate an API key from your
    [account settings](https://www.latitude.sh/dashboard/account/api):

    ```bash theme={null}
    lsh login <API_KEY>
    ```
  </Step>

  <Step title="Mount the volume">
    Mount the volume to the server:

    ```bash theme={null}
    sudo lsh volume mount --id <VOLUME_ID>
    ```

    You will be prompted to enter the mount point for the volume.
  </Step>
</Steps>

<Info>
  You can find your block storage ID in the dashboard under **Storage** >
  **Block storage** by clicking on the three dots icon and selecting **Mount
  volume to bare metal**.
</Info>

### Managing Block Storage

#### Detaching

To safely detach a volume from a server, unmount the volume first:

```bash theme={null}
umount /path/to/mount/point
```

> **Note:** Detaching volumes from servers via the dashboard is not currently supported. This feature will be available in a future update.

### Pricing

Block Storage is free during the preview period.