---
sidebar_position: 61
---

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

# `lium gpu-splitting`

Prepare Docker storage on a provider node so the host can be split across multiple renters. This is a **provider-side** command, run on the host.

```bash
lium gpu-splitting SUBCOMMAND [OPTIONS]
```

GPU splitting requires an XFS-backed Docker storage driver on a non-root disk. These subcommands inspect the host, verify it meets the requirements, and (with `setup`) reconfigure Docker on a target device.

## Subcommands

### `lium gpu-splitting check`

Inspect the host and print the plan **without making any changes**.

```bash
lium gpu-splitting check [--device /dev/<dev>]
```

| Flag | Effect |
|------|--------|
| `--device PATH` | Inspect a specific block device instead of auto-selecting |

Outputs the current Docker state, candidate target devices, and what `setup` would do.

### `lium gpu-splitting verify`

Verify the host already matches the GPU-splitting requirements.

```bash
lium gpu-splitting verify
```

Exits non-zero if any requirement is not satisfied. Use this after `setup` to confirm.

### `lium gpu-splitting setup`

Perform end-to-end Docker storage setup for GPU splitting. This is the only destructive subcommand.

```bash
sudo lium gpu-splitting setup [--device /dev/<dev>] [--yes]
```

| Flag | Effect |
|------|--------|
| `--device PATH` | Target a specific block device (else auto-selected) |
| `--yes` | Skip the interactive confirmation |

`setup` rejects the root disk and the disk currently backing `/var/lib/docker` — it requires a separate, non-root device. There is no supported single-disk path; attach a second disk or reinstall onto an XFS root first.

## Examples

```bash
# Inspect before doing anything
lium gpu-splitting check
lium gpu-splitting check --device /dev/nvme1n1

# Apply on a specific device
sudo lium gpu-splitting setup --device /dev/nvme1n1
sudo lium gpu-splitting setup --device /dev/nvme1n1 --yes

# Confirm requirements after setup
lium gpu-splitting verify
```

## See also

- [GPU splitting](/providers/nodes/gpu-splitting) — concept guide
- [Docker storage](/providers/nodes/docker-storage) — XFS / device requirements
- [`lium mine`](./mine.md) — bring the node online first