Skip to content

config.md

Latest commit

 

History

History
110 lines (77 loc) · 2.17 KB

config.md

File metadata and controls

110 lines (77 loc) · 2.17 KB

Config

DVM has two config layers.

Global defaults:

~/.config/dvm/config.sh

Per-VM config:

~/.config/dvm/vms/<name>.sh

The global config is loaded first, then the per-VM config. Because config is shell, a VM can inherit, append, replace, or clear global values.

Global Defaults

Use global config for settings that apply to most VMs:

DVM_CPUS="2"
DVM_MEMORY="4GiB"
DVM_DISK="40GiB"
DVM_NETWORK="user-v2"

DVM_PACKAGES="git ripgrep fd-find jq helix yazi"
DVM_SETUP_SCRIPTS="common.sh"

Put shared setup in:

~/.config/dvm/recipes/common.sh

Use DVM_PACKAGES for simple Fedora packages. Use common.sh for anything that needs extra commands, external repos, service setup, or custom logic.

Dotfiles are optional and workflow-specific. See Dotfiles for plain snapshot, bare repo, yadm, and chezmoi examples.

Example ~/.config/dvm/recipes/common.sh:

#!/usr/bin/env bash
set -euo pipefail

sudo dnf5 install -y git ripgrep fd-find jq helix yazi

if ! rpm -q terra-release >/dev/null 2>&1; then
	sudo dnf5 install -y --nogpgcheck \
		--repofrompath "terra,https://repos.fyralabs.com/terra$releasever" \
		terra-release
fi
sudo dnf5 install -y lazygit

sudo dnf5 install -y nodejs npm
if ! command -v corepack >/dev/null 2>&1; then
	sudo npm install -g corepack@latest
fi
sudo corepack enable
sudo corepack prepare pnpm@latest --activate

Per-VM Additions

Append to global packages or setup:

DVM_PACKAGES="$DVM_PACKAGES nodejs pnpm"
DVM_SETUP_SCRIPTS="$DVM_SETUP_SCRIPTS node.sh"

Add inline setup for one VM:

dvm_vm_setup() {
	mkdir -p "$DVM_CODE_DIR/myapp"
}

Per-VM Overrides

Replace global defaults:

DVM_PACKAGES="git python3 uv"
DVM_SETUP_SCRIPTS="python.sh"

Disable global setup for special VMs like ai or cloudflared:

DVM_PACKAGES=""
DVM_SETUP_SCRIPTS="llama.sh"

Generated Examples

dvm init <name> creates a general per-VM template. Some common names get extra commented examples:

  • dvm init ai: llama VM hints
  • dvm init cloudflared: cloudflared connector VM hints

These are examples only. Nothing is enabled until you uncomment or add values.