THYMIS

Quickly provision, configure, and manage devices using NixOS.

Thymis is an open-source platform designed for managing and configuring IoT devices. Built on the robust NixOS operating system, Thymis ensures consistency, reliability, and ease of management across diverse IoT landscapes. Whether you're managing a few devices or a large-scale deployment, Thymis provides the tools needed to streamline your operations.

The documentation is available at thymis.io/docs.

---

Screenshot & Demo

Overview

Key features of Thymis include:

• Device Provisioning: Easily provision new devices with pre-configured system images.
• Device Configuration: Configure devices using a web-based interface.
• Device Management: Monitor device status, manage device modules, and deploy updated configurations to devices.
• REST API: Expose a REST API for CRUD operations on device and configuration data.
• NixOS Integration: Leverage the power of NixOS for declarative system configuration.
  • nixpkgs: According to Repology, nixpkgs has over 60000 packages with the latest version available. This makes it the largest collection of up-to-date software packages available for any Linux distribution. You can use any of these packages in your Thymis project.
  • Deployments without wasted bandwidth: Only changed paths are sent to the device, reducing the amount of data sent over the network.
  • Deployments without downtime: The device is updated atomically, ensuring that the device is always in a consistent state.
  • Rollbacks: If the device fails to boot after an update, the device can be rolled back to the previous state.
  • Reproducible builds: The same configuration will always produce the same result, ensuring that the device is always in a consistent state.
  • Air-gapped deployments: Devices can be updated without needing to connect to the internet. Only a connection to the Thymis controller is required. Deployments using Mass Storage is possible but not yet implemented.
• Device tagging: Tag devices to group them together for easier management.

---

Architecture

The project uses SvelteKit for the frontend and FastAPI for a device controller. The frontend communicates with the controller using a REST API. The controller is responsible for managing device and module data.

---

Getting Started (Development)

Requirements

Ensure you have the following dependencies installed on your system:

• Nix (with Flakes support)

Installation

1. Clone the thymis repository:

git clone https://github.com/Thymis-io/thymis

2. Change to the project directory:

cd thymis

3. Enter an environment with the required dependencies:

nix develop

4. Install the frontend and controller dependencies:

cd frontend
npm install
cd ../controller
uv sync

Running thymis

Use the following command to run thymis:

cd controller
uv run uvicorn thymis_controller.main:app --reload

The controller takes care of running the frontend for you. You can access thymis at http://localhost:8000.

---

Project Roadmap

• Release 0.1.0

  • Initial release of the project
  • Basic device management features

• Release 0.2.0

  • Various bug fixes and improvements

• Release 0.3.0

  • Task persistence using the database
  • Update to nixpkgs/NixOS 24.11

• Release 0.4.0

  • Automatic rollback if OTA update fails or condition is met

• Release 0.5.0

  • Added secrets management
  • Fixed unresponsive navigation when the page invalidates data at the same time, see sveltejs/kit#9354

• Release 0.6.0

  • Added artifact management
  • Logs are now collected into the database

• Release 0.7.0

  • Improved External Repository UI
  • Added Bash + Python Module
  • Update to nixpkgs/NixOS 25.05

• Release 0.8.0

  • Added device details page, auto updates and reworked overview page
  • Update to nixpkgs/NixOS 25.11

• Release 0.9.0

  • UI Redesign & performance fixes

• Release 0.10.0

  • New features and bug fixes, possibly containing breaking changes

---

License

This project is protected under the GNU Affero General Public License v3.0 License. For more details, refer to the LICENSE file.

---

Acknowledgments

We love using these technologies and tools:

• NixOS
• Svelte
• FastAPI
• Python
• Node.js