Skip to content

Repository files navigation

Draupnir

LicenseCIReleaseTest

Lightweight per-instance agent for Sindri environments, connecting to the Mimir control plane.

Draupnir runs on each managed instance, providing real-time metrics, remote terminal access, and command dispatch over a persistent WebSocket connection.

Features

  • System metrics collection (CPU, memory, disk, network)
  • Heartbeat monitoring with configurable intervals
  • Remote terminal sessions (PTY allocation)
  • Command dispatch and result streaming
  • Lifecycle event reporting
  • Static binary — no runtime dependencies

Quick Start

Install via Sindri

sindri extension install draupnir

Manual install

curl -fsSL https://raw.githubusercontent.com/pacphi/draupnir/main/extension/install.sh | bash

Build from source

make build

Configuration

VariableRequiredDefaultDescription
SINDRI_CONSOLE_URLyesMimir control plane URL
SINDRI_CONSOLE_API_KEYyesAuthentication key
SINDRI_INSTANCE_IDnohostnameUnique instance identifier
SINDRI_PROVIDERnofly, docker, k8s, e2b, devpod
SINDRI_REGIONnoGeographic region
SINDRI_AGENT_HEARTBEATno30Heartbeat interval (seconds)
SINDRI_AGENT_METRICSno60Metrics interval (seconds)
SINDRI_AGENT_TAGSnoComma-separated key=value labels
SINDRI_LOG_LEVELnoinfodebug/info/warn/error

Supported Platforms

OSArchitectureBinary
Linuxamd64draupnir-linux-amd64
Linuxarm64draupnir-linux-arm64
macOSamd64draupnir-darwin-amd64
macOSarm64 (M-series)draupnir-darwin-arm64

CI

make ci # vet, format-check, test, build-all

Related Projects

  • sindri — CLI tool + extension ecosystem
  • mimir — Fleet management control plane

License

MIT

About

Draupnir — lightweight per-instance agent for Sindri fleet management

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages