How tranquilit/wapt works
Purpose and topology
WAPT is an archived GPLv3 endpoint software-deployment system: administrators publish signed software/configuration packages, a central server coordinates repositories and endpoints, and installed agents apply work locally. It spans Python services/CLI tooling and Lazarus/Free Pascal desktop clients.
Package authoring, metadata, and trust
The package domain is centralized in Python tooling for creating, inspecting, signing, and indexing deployable packages. Package templates encode installer-specific setup scripts; cryptographic operations form the trust boundary before packages enter repositories.
• waptpackage.py
• waptcrypto.py
• wapt-signpackages.py
• wapt-scanpackages.py
• templates/setup_package_template.py.tmpl
Endpoint command interface
wapt-get.py is the principal agent CLI, with shell/batch launchers. It consumes agent configuration, queries package sources/server, resolves package actions, and executes deployment through the shared package/setup layers. The wapt-get/ Pascal project supplies native GUI/helper and platform integration code.
• wapt-get.py
• wapt-get.sh
• wapt-get/waptget.lpr
• common.py
• setuphelpers.py
Local agent service and user-facing API
A resident Python service schedules and exposes endpoint package operations, tracks networking, and serves local web/UI endpoints. Socket.IO modules indicate real-time task/status communication; self-service, tray, exit, and message applications are separate Lazarus front ends over the local agent behavior.
• waptservice/service.py
• waptservice/waptservice_common.py
• waptservice/waptservice_socketio.py
• waptself/waptself.lpr
• wapttray/wapttray.lpr
Central server and control plane
The server is a Python web application with API, authentication, data model, task processing, and Socket.IO support. It exposes administrator-facing templates/static assets and is the boundary between managed hosts, package repositories, and privileged administrative actions.
• waptserver/app.py
• waptserver/api.py
• waptserver/auth.py
• waptserver/model.py
• waptserver/server_socketio.py
Background orchestration and infrastructure
Server task modules separate long-running fleet actions from request handling. Deployment scripts target Linux services with systemd, uWSGI, Nginx, SSL, logging, and optional Kerberos setup; runnable wrappers distinguish the server, agent, and task-worker processes.
• waptserver/tasks.py
• waptserver/wapthuey.py
• waptserver/scripts/waptserver-uwsgi.service
• waptserver/scripts/wapt-with-uwsgi.nginxconfig
• runwapttasks.sh
Administrative and delivery clients
The Lazarus console is the administrator desktop client for host/package/repository management. Installers build Windows (Inno Setup), Debian, RPM, and macOS artifacts, reflecting cross-platform agent/server distribution rather than a single runtime deployment.
• waptconsole/waptconsole.lpr
• waptsetup/wapt.iss
• waptservice/deb/createdeb.py
• waptservice/rpm/waptagent.spec
• waptservice/pkg/createpkg.py
Main entry points: service.py Resident agent service · api.py Server API · app.py Server web app · wapt-get.py Agent CLI
Components 19
Package & trust
- Package tooling · Creates, inspects, and prepares deployable packages.
waptpackage.py - Setup templates · Installer-specific package setup templates.
templates/setup_package_template.py.tmpl - Signing & crypto · Signs packages before repository publication.
wapt-signpackages.py - Package indexer · Scans packages and produces repository metadata.
wapt-scanpackages.py
Endpoint
- Agent CLI · Resolves and executes endpoint package actions.
wapt-get.py - Agent setup layer · Shared configuration and deployment helpers.
common.py - Native agent helper · Platform-integrated GUI/helper project.
wapt-get/waptget.lpr - Resident agent service · Schedules local operations and exposes endpoint behavior.
waptservice/service.py - Agent real-time channel · Task and status communication for the local service.
waptservice/waptservice_socketio.py - Self-service UI
waptself/waptself.lpr - Tray UI
wapttray/wapttray.lpr
Control plane
- Server web app · Administrative boundary for managed hosts and repositories.
waptserver/app.py - Server API
waptserver/api.py - Auth & data model · Authentication and persistent control-plane data.
waptserver/model.py - Server real-time channel
waptserver/server_socketio.py - Fleet task worker · Runs long-lived fleet actions outside request handling.
waptserver/tasks.py - Server deployment stack · uWSGI, Nginx, systemd, SSL, and logging deployment.
waptserver/scripts/waptserver-uwsgi.service
Clients & delivery
- Admin console · Manages hosts, packages, and repositories.
waptconsole/waptconsole.lpr - Cross-platform installers · Windows, Debian, RPM, and macOS delivery builds.
waptsetup/wapt.iss
Connections 21
- Setup templates → Package tooling: defines setup
- Package tooling → Signing & crypto: package payload
- Signing & crypto → Package indexer: signed packages
- Package indexer → Server web app: repository metadata
- Agent CLI → Agent setup layer: uses
- Native agent helper → Agent CLI: launches
- Resident agent service → Agent setup layer: executes deployments
- Self-service UI → Resident agent service: requests operations
- Tray UI → Resident agent service: controls
- Agent CLI → Server API: queries packages
- Resident agent service → Agent real-time channel: publishes status
- Agent real-time channel → Server real-time channel: task/status events
- Server web app → Server API: hosts
- Server API → Auth & data model: authorizes and persists
- Server web app → Server real-time channel: hosts
- Server API → Fleet task worker: queues fleet actions
- Fleet task worker → Agent real-time channel: orchestrates endpoint work
- Server deployment stack → Server web app: serves
- Admin console → Server API: administration
- Cross-platform installers → Resident agent service: installs agent
- Cross-platform installers → Server deployment stack: installs server stack