Skip to content
This repository was archived by the owner on Aug 18, 2025. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from 1 commit
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
61 changes: 59 additions & 2 deletions admin/workspace-management/cvms/management.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,12 @@ a site manager must enable CVMs. To do so:
1. Go to **Manage > Admin > Infrastructure**.
1. Toggle the **Enable Container-Based Virtual Machines** option to **Enable**.

## Cached CVMs
This section describes the customization features that Coder offers for CVMs as
well:

![CVM Settings](../../../assets/admin/cvm-settings.png)

## Caching

> Cached CVMs are currently an **alpha** feature.

Expand All @@ -27,4 +32,56 @@ install `shiftfs` on your behalf.**

> GPUs are not supported with cached CVMs at this time.

![Cached CVMs](../../../assets/admin/cached-cvms.png)
## Self-contained workspace builds

> Self-contained workspace builds are currently an **alpha** feature.

By default, Coder initializes workspaces by running commands inside the
container. When you enable [self-contained workspace builds], workspaces control
the initialization sequence instead. This enables operation on clusters that
restrict command execution inside containers using the Kubernetes API, such as
with the `kubectl exec` command.

[self-contained workspace builds]: ../self-contained-builds.md

## Workspace process logging

> Workspace process logging is currently an **alpha** feature.

[Workspace process logging] enables auditing of commands executed inside the
workspace container.

[workspace process logging]: ../process-logging.md

## TUN device

> TUN devices currently an **alpha** feature.

Coder allows the creation of custom network interfaces using the kernel TUN
device. When using the **Enable TUN device** setting, Coder workspaces will have
a `/dev/net/tun` device mounted into the workspace at build time. These devices
are often required for VPN clients, such as OpenVPN and Tailscale.

> At this time, Coder does not support TUN devices for other workspace types
> (such as EC2 or Docker).
>
> If you're working with EC2 workspaces, we recommend enabling privileged mode
> in the workspace provider settings, which will allow users to create their own
> TUN device.

## FUSE device

> FUSE devices currently an **alpha** feature.

Coder allows the creation of custom filesystems using the kernel TUN device.
When using the **Enable FUSE device** setting, Coder workspaces will have a
`/dev/fuse` device mounted into the workspace at build time. These devices are
frequently used to mount specialized filesystems, such as Google Cloud Storage
buckets, as a filesystem volume.

> At this time, Coder does not support FUSE devices for other workspace types
> (such as EC2 or Docker).
>
> If you're working with EC2 workspaces, we recommend enabling privileged mode
> in the workspace provider settings, which will allow users to create their own
> FUSE device.
38 changes: 0 additions & 38 deletions admin/workspace-management/tun-device.md

This file was deleted.

Binary file removed assets/admin/cached-cvms.png
Binary file not shown.
Binary file added assets/admin/cvm-settings.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 0 additions & 3 deletions manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -312,9 +312,6 @@
{
"path": "./admin/workspace-management/ssh-access.md"
},
{
"path": "./admin/workspace-management/tun-device.md"
},
{
"path": "./admin/workspace-management/process-logging.md"
}
Expand Down