Skip to content
Afa' Afa'

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:

  1. 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-nfs extension. 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.

  2. 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: compose alongside 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

  • resolve Command – Parses, resolves, and renders compose files.
  • setup Command – Configures storage node and storage replica nodes.
  • volumes Command group – Manage shared volumes (create, sync, mount, unmount).
  • deploy Command – Deploys or updates Compose/Swarm stacks.
  • down Command – Stops and removes containers, networks, and resources.
  • check Command – Verifies and lists nodes matching placement constraints, along with their Docker Context availability.

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.

Daily commit activity over the project's whole history. Each cell is one day; darker cells mean more commits.
Mon Wed Fri

Contributors

Search articles and projects

Type to filter articles and projects. Use the arrow keys to move through results and Enter to open one. Press Escape to close.