Skip to main content

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.

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.

lium gpu-splitting check [--device /dev/<dev>]
FlagEffect
--device PATHInspect 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.

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.

sudo lium gpu-splitting setup [--device /dev/<dev>] [--yes]
FlagEffect
--device PATHTarget a specific block device (else auto-selected)
--yesSkip 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​

# 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​