Skip to main content
If you have complex redundancy or performance requirements, you can control how your server’s disks are grouped, formatted, and mounted with a custom disk layout. When you deploy or reinstall a server, enable Custom disk layout in the Advanced section to define exactly how disks are grouped and which RAID level each group uses. This page explains how the custom disk layout editor works and the supported RAID levels. Custom disk layout editor

​
Availability

Custom disk layouts require a server with at least two disks and an operating system that supports software RAID. They are not available for iPXE installs or instant deployments. Use the /plans endpoint to check compatibility.

​
Custom disk layout

Enable Custom disk layout to split your server’s disks into up to three groups, each with its own role:
  • Each group’s RAID level can be No RAID, RAID 0, or RAID 1. RAID 0 and RAID 1 require at least two disks within that group.
  • The Storage group is formatted with the filesystem ext4 and mounted at the mount point you choose, which defaults to /data.
  • Use Quick apply to fill the entire layout with a sensible default at a single RAID level (see Default configuration).
You can also configure the disk layout through the API by passing a disk_layout array to the create server and reinstall endpoints. Each entry sets a role (os, storage, or raw), a disk count, and — where applicable — a raid_level and mount_point. For infrastructure-as-code workflows, the Latitude.sh Terraform provider supports custom disk layouts through the disk_layout attribute on a latitudesh_server resource. Each disk group accepts the same fields as the API — a role, a disk count, and, where applicable, a raid_level and mount_point. The disk_layout attribute is mutually exclusive with the simpler raid attribute, and changing it triggers a reinstall, so the server must allow reinstalls. See the provider documentation for the full attribute schema.

​
Default configuration

When you apply a simple RAID level — either with Quick apply in the custom disk layout editor, or by deploying without customizing the layout — disks are grouped automatically based on how many the server has: You can fine-tune any of these defaults in the custom disk layout editor before deploying or reinstalling.

​
RAID levels explained

The RAID level is what determines the relationship of the disks. There are numerous RAID levels but only the ones supported by Latitude.sh are explained here.

​
RAID 0

RAID 0 combines two or more disks by striping data across them, which means that chunks of data are written to each disk in the array alternately. This gives you a great performance improvement as the data is distributed between disks and each one can be utilized for both reads and writes. This approach offers great performance as you get the performance of a single disk multiplied by the number of disks in the array and also get the combined capacity of all drives, but there is one important drawback that needs to be considered. As data is being split up and divided between the disks in the array if one of the disks fails the entire array and all data is lost because the failure of a disk will remove the chunks that were written to it from the array, leaving the other disks with incomplete (as in corrupted) data. RAID 0 arrays cannot be rebuilt as there will be no knowledge by the other devices of the data that needs to be reconstructed. If you decide to run a RAID 0 array, backups are extremely important, as your entire data set depends equally on the reliability of each of the disks in the array.

​
RAID 1

RAID 1 is a configuration that mirrors data between two or more disks. Everything written to the array is placed on each of the devices in the group, so each disk has a complete set of the available data. This means that you have redundancy in case of device failure. In a RAID 1 array, data is accessible as long as a single disk in the array is functioning properly. The array can be rebuilt by replacing failed drives, at which point the remaining disks will be used to copy the data back to the new device. In RAID 1 it’s especially important that all disks in the array are performing well, as the performance of write operations will be that of the slowest device in the array. This happens because the whole piece of data must be written to each of the disks in the array. It’s also important to note that, as all of the data lives in each disk, the total capacity of the array will be that of the smallest disk. Adding new disks increases the number of redundant copies of the data, but doesn’t increase the amount of available capacity. For read operations, the theoretical performance is the same as with RAID 0 where you multiply the read speed of a single disk by the number of disks.