Introduction
Welcome to the Thymis documentation.
Thymis is an open‑source platform for managing IoT devices using the declarative power of NixOS. It enables you to provision, configure, update, and monitor fleets of devices with full reproducibility and reliability — whether they’re in the cloud, on‑premises, or behind NAT.
Who This Is For
- IoT solution vendors deploying and maintaining large device fleets.
- Developers creating custom applications for embedded Linux devices.
- Ops/IT teams needing reproducible, version‑controlled device configurations.
If you need a secure, infrastructure‑as‑code‑style way to manage devices — from Raspberry Pi kiosks to generic x86 gateways — Thymis provides the tooling.
What You’ll Find in This Documentation
Getting Started Step‑by‑step setup for Thymis Cloud or self‑hosting, including NixOS deployments and planned OCI‑container support.
Device Lifecycle Guides for provisioning devices, sharing settings with Tags, enabling Kiosk mode with VNC, performing updates, testing in VMs, and troubleshooting.
Projects & Modules How to integrate external repositories, use and create Thymis Modules, package software with Nix, and tailor devices to your applications.
Reference Comprehensive background on concepts (devices, deployments, configurations, tags, modules, secrets, artifacts), administration, UI field reference, and supported hardware.
Community & Support
Thymis is developed by Udysseus GmbH and released under AGPL‑3.0.
For updates, source code, and community discussions:
Ready to begin?
Start with Setting Up Thymis or use the sidebar to explore guides, module references, and lifecycle workflows for your devices.