Skip to content
This repository was archived by the owner on Aug 18, 2025. It is now read-only.
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions admin/workspace-management/cvms/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,8 @@ deployment option.
Kubernetes Node must run a supported Linux distro with the minimum kernel
version. See
[Sysbox distro compatibility](https://github.com/nestybox/sysbox/blob/master/docs/distro-compat.md)
and
[Sysbox User Guide: Design Notes](https://github.com/nestybox/sysbox/blob/master/docs/user-guide/design.md)
for more information.

- The cluster must allow privileged containers and `hostPath` mounts. See
Expand All @@ -28,6 +30,24 @@ deployment option.
> [Google](../../../setup/kubernetes/google.md). Azure-hosted clusters will meet
> these requirements as long as you use Kubernetes version 1.18+.

### HostPath mounts

The host paths required for CVM functionality depend on whether you've enabled
**Caching** and **Auto loading of the `shiftfs` kernel module**. You can find
these settings under **Manage > Admin > Infrastructure**.

The following table documents the host paths that are mounted:

<!-- markdownlint-disable -->

| Caching | Auto Load `shiftfs` | `/usr/src` | `/lib/modules` | `/var/run` | `/var/lib` |
| ------- | ------------------- | ---------- | -------------- | ---------- | ---------- |
| Off | N/A | Read-only | Read-only | | |
| On | Off | Read-only | Read-only | Read-only | Read-write |
| On | On | Read-write | Read-write | Read-only | Read-write |

<!-- markdownlint-restore -->

## Security

The container-based virtual machine deployment option leverages the Sysbox
Expand Down