Skip to content
OpenCharly

workspace-mount

Recipe card from the charly-distros plugin (Images — the deployable catalog).

workspace-mount — virtiofs /workspace mount

Section titled “workspace-mount — virtiofs /workspace mount”

A guest-side candy that mounts the virtiofs share tagged workspace at /workspace and enables it so it re-mounts on every boot — load-bearing for an autostarting VM that must come back with its share already mounted.

What it does

Section titled “What it does”
  • mkdir /workspace
  • writes /etc/systemd/system/workspace.mount (What=workspace, Where=/workspace, Type=virtiofs, WantedBy=multi-user.target)
  • systemctl daemon-reload + enable (boot) + start (now, tolerant) — the start is || true so an image-build chroot with no device / no systemd does not fail the candy; the enabled unit mounts at the next boot.

The contract

Section titled “The contract”

The mount tag workspace is the contract between the host-side share and this candy. The kind: vm entity must declare a matching virtiofs filesystem:

libvirt:
  devices:
    filesystems:
      - {driver: virtiofs, accessmode: passthrough, source: /home/me, target: workspace}

target: workspace (the entity) ↔ What=workspace (this candy). The shared memory backing virtiofs requires is auto-paired by the renderer (see /charly-internals:libvirt-renderer), so the entity declares only the filesystem.

Check

Section titled “Check”
  • workspace-mount-unit — the .mount unit file contains Type=virtiofs.
  • workspace-virtiofs-rw — skip-aware: N/A when no share is attached (image build / no-device target); when /workspace IS mounted it MUST be virtiofs and writable. Mirrors the GPU check gate’s skip-with-explanation pattern.

Used in

Section titled “Used in”

The cachyos-coder operator workstation VM (box/cachyos), mounting the operator’s /home/<user> → /workspace. Generic for any pod-in-VM share.

Section titled “Related”

When to Use This Skill

Section titled “When to Use This Skill”

Use when authoring or debugging a virtiofs host-directory share mounted into a VM guest, or the workspace-mount candy specifically.