Project
Ṣeto
An orchestrator for Docker Swarm and Compose deployments with device targeting and automated NFS storage provisioning
262 commits 1 contributor Updated Nov 2026
Overview
Ṣeto is a robust command-line orchestration tool designed to automate the configuration, provisioning, and synchronization of shared storage volumes using an NFS driver. It provides a unified, developer-friendly workflow for managing multi-host stack-based deployments (supporting both Docker Swarm and multi-host Docker Compose)—taking care of everything from NFS server/client setup and directory synchronization to volume mounting, health verification, and container lifecycle.
Why Ṣeto?
Deploying containerized applications across multiple servers (using Docker Swarm or Docker Compose) introduces two major challenges that Ṣeto is built to solve:
The Shared Persistent Storage Dilemma: When running a service cluster, containers on different hosts often need to access or modify the same files (e.g., config files, logs, shared uploads, or media directories). Setting up a central NFS server, exporting directories, configuring client-side utilities, mounting paths, updating
/etc/fstab, and keeping local/remote directories synced is complex, tedious, and prone to configuration drift.How Ṣeto solves it: It provides a declarative
volumes-nfsextension. You write simple paths in your Compose file, and Ṣeto automatically installs the NFS server/clients, configures/etc/exports, handles dynamic sync, and mounts the volumes cluster-wide.The Swarm Hardware Limitation: Docker Swarm is excellent for simple stateless microservices but natively struggles with direct hardware mapping. If your containers need to access physical host resources—such as a specific GPU, a USB controller (like Zigbee or Zwave sticks), Bluetooth, cameras, or Edge TPUs—Swarm makes it extremely difficult to map these resources directly.
How Ṣeto solves it: It introduces
x-mode: composealongside hardware validation. Ṣeto evaluates custom placement constraints (e.g.,host.device.gpu == true), physically verifies device drivers on remote nodes over SSH, and deploys services directly via Docker Compose on the target machines—while preserving communication across unified Docker overlay networks.
Features
resolveCommand – Parses, resolves, and renders compose files.setupCommand – Configures storage node and storage replica nodes.volumesCommand group – Manage shared volumes (create, sync, mount, unmount).deployCommand – Deploys or updates Compose/Swarm stacks.downCommand – Stops and removes containers, networks, and resources.checkCommand – Verifies and lists nodes matching placement constraints, along with their Docker Context availability.
Project Links
Technology
- cli
- devops
- docker
- docker-compose
- docker-swarm
- infrastructure
- nfs
- orchestration
- Python
- storage
Repository information
- Primary language
- Python
- Created
- August 22, 2024
- Last activity
- November 18, 2026
Activity
Daily commits on the default branch, across the whole project history.
