Edera system components

2 min read · Beginner


This page defines key binaries and resources used by Edera and its supporting services. While the CLI usage guide explains how to interact with the system via the command line, this reference focuses on what each binary or file does, where it lives on the system, and how it fits into the broader Edera runtime. Use this as a quick lookup when diagnosing issues or exploring system internals.

Core binaries

NameTypePurposeLocation
protect-networkLong-lived BinaryProvides networking to isolated zones via userspace bridges/usr/sbin
protect-daemonLong-lived BinaryService which provides the control API to manage isolated zones/usr/sbin
kube-spdy-proxyLong-lived BinaryTranslate legacy SPDY protocol in Kubernetes to modern HTTP/2.0/usr/sbin
protect-criLong-lived BinaryProvide the Container Runtime interface via the protect-daemon API/usr/sbin

Command-line

NameTypePurposeLocation
protectCommand-line BinaryTool to connect to the control API, diagnose problems/usr/sbin

Boot time & zone components

NameTypePurposeLocation
xenBootable BinaryProvides the Edera Protect Xen hypervisor at boot time/boot
kernelZone ResourceDefault kernel image to boot inside of a zone/var/lib/edera/protect/zone
addons.squashfsZone ResourceDefault kernel addons (modules and driver bits)/var/lib/edera/protect/zone
initrdZone ResourceDefault initial ramdisk to boot inside of a zone/var/lib/edera/protect/zone

Runtime

NameTypePurposeLocation
host.uuidRuntime ResourceStores the UUID of the host (separate from hardware UUID)/var/lib/edera/protect
protect.dbRuntime ResourceStores critical zone management information/var/lib/edera/protect
cri.v1.jsonRuntime ResourceStores information about the runtime of the CRI/var/lib/edera/protect
cacheRuntime DirectoryOCI and data cache files/var/lib/edera/protect

KVM backend components (Early Access)

These components are installed and invoked only on the KVM backend. On the Xen backend they are not present. See Install Edera for the install path and components reference for source pins and roles.

NameTypePurposeLocation
cloud-hypervisorPer-zone BinaryUserspace VMM that launches and manages each zone’s VM/usr/libexec/edera-protect
virtiofsdPer-zone BinaryUserspace daemon serving volume mounts to zones using virtio-fs/usr/libexec/edera-protect

File type key

File TypeUsage
Long-lived BinaryStarts at system boot and stays running
Command-line BinaryInvoked by humans or automation
Bootable BinaryLaunched by the system bootloader
Per-zone BinaryLaunched by the daemon per zone; lives for the zone lifetime
Zone ResourceLoaded by the daemon for zone use
Runtime ResourceCreated and managed by services
Runtime DirectoryCreated and managed by services
Last updated on