Hide navigation sidebar
Hide table of contents sidebar
Skip to content
Quickstart Official documentation Setuphelpers Changelog FAQ
Back to top
View this page
Toggle table of contents sidebar

# WAPT documentation

Welcome to WAPT’s official documentation by Tranquil IT, last compiled on 2026-01-30.

Official Documentation

All WAPT features explained

Main benefits
WAPT Quickstart

Starting with WAPT

Quickstart - Guides
Setuphelpers

All commands to create WAPT packages

WAPT Setuphelpers apidoc
Changelog

Changelog

Changelog
Contact

LinkedIn, Discord, Forum, Official website…

Contacting Tranquil IT
FAQ

Frequently asked questions about using WAPT.

FAQ - Guides

## Main benefits

WAPT is a software and configuration deployment tool that may be compared to Microsoft SCCM (now called MECM), Ivanti UIM, IBM Bigfix, Tanium, OPSI, PDQDeploy, or Matrix42. WAPT exists in two flavors, WAPT Discovery and WAPT Enterprise.

For System Administrators:

- Install software and configurations silently.

- Maintain up to date an installed base of software and configurations.

- Configure software at the system and user level to reduce the load on support teams.

- Remove unwanted or out of cycle software and configurations silently.

- Reduce your need for support by your IT teams, whose reaction times are often long because of their workloads.

- Reduce as much as possible the consumption of bandwidth on remote sites to preserve it for productive uses.

For IT Security Officers

- Pilot the software installed base to converge to a security standard acceptable to the organization.

- Prepare your enterprise for the coming GDPR and help your DPO keep his register of data processing, because you two will become close colleagues.

- No longer tolerate hosts operating in Administrator mode.

- No longer tolerate users downloading and running software binaries from their home directory.

- Start applying SRPs, also known as Applocker or WDAC to improve application level IT security.

- Reduce the level of exposure to software vulnerabilities and lateral movement attacks.

- Bring up audit indicators for a better knowledge of the state of installed IT devices and their global security level.

- Be prompt to deploy updates to react to cyber attacks like Wannacry or notPetya.

For End-Users

- Have installed software configured to work well in the context of your Organization and trust that they will work correctly.

- Give Users more autonomy to install software safely and reliably.

- Have better working and more predictable professional systems because of standard software configurations.

## Table Of Contents Tree

Presenting WAPT

- Fundamental principles of WAPT
  - Introduction to WAPT
  - Fundamental principles
  - WAPT mode of operation
  - Database architecture on the agent
  - WAPT Server architecture
  - WAPT language and development environment
- WAPT Editions and Versions history
  - Currently supported versions
  - Out of support versions
  - Summary of operating principles in WAPT
  - Current feature list as of 2026-01-30
  - Features coming soon
  - Main functional benefits of the Enterprise version of WAPT
  - Targeted use cases of WAPT Enterprise
  - Description of services available with a WAPT Enterprise contract

WAPT Quickstart

- 1. Quickstart - Guides
- 2. Quickstart - Installing The WAPT Server
  - 2.1. To read beforehand
  - 2.2. Installing WAPT server
- 3. Quickstart - Installing The WAPT Console
  - 3.1. Installing the WAPT Setup on the Administrator’s computer
  - 3.2. Generating the Administrator’s certificate for signing WAPT packages
  - 3.3. Packet prefix definition
  - 3.4. Activating a WAPT licence
  - 3.5. Creating the WAPT Agent
- 4. Quickstart - Installing The WAPT Agent
- 5. Quickstart - WADS for Windows
  - 5.1. Deploying a Windows machine in the domain, with offline connection
- 6. Quickstart - WADS for Linux
  - 6.1. Deploying a Linux machine in the domain, with offline connection

WAPT Server

- 1. Checking requirements
- 2. Installing WAPT Server
- 3. Upgrade WAPT Server
- 4. Backup WAPT Server
- 5. Restore WAPT Server
- 6. WAPT Server APIs
- 7. WAPT Server Advanced Configuration
- 8. Enhancing WAPT Server Security - Server side

WAPT Console

- 1. How to install the management WAPT console
- 2. How to use the WAPT Console
- 3. WAPT Console advanced mode
- 4. WAPT Secondary Repo
- 5. WAPT Peercache
- 6. WAPT Self Service
- 7. WAPTWUA
- 8. WADS OS deployement
- 9. WAPT Reporting
- 10. WAPT Audit Data
- 11. Enhancing WAPT Server Security - Console side

WAPT Agent

- 1. Deploying the WAPT Agent
  - 1.1. Deploying the WAPT Agent on Windows
  - 1.2. Deploying the WAPT Agent on Linux and macOS
- 2. Updating the WAPT Agent
  - 2.1. Updating on Windows
  - 2.2. Updating on Linux and macOS
- 3. Removing the WAPT Agent
  - 3.1. Windows
  - 3.2. Linux
  - 3.3. macOS
- 4. WAPT Command Line Interface
  - 4.1. Using the more common functions in WAPT with the command line
  - 4.2. Using special Command Lines with WAPT
  - 4.3. Using the Command Line for user session setup
  - 4.4. Using the Command Line to create WAPT packages
  - 4.5. Using the command-lines for WaptWUA management
  - 4.6. Using the command-line for interacting with users
  - 4.7. Using the command-lines for initial setup
  - 4.8. Using the command-lines with options
- 5. Advanced WAPT configuration
  - 5.1. Description of available sections
  - 5.2. Description of available options by section
  - 5.3. Settings for using multiple repositories

Creating WAPT packages

- 1. Getting start creating WAPT packages
  - 1.1. Setting up your WAPT development and test environment
  - 1.2. Principles of creating package template from the WAPT Console
  - 1.3. Creating your first WAPT Packages
- 2. WAPT Packages Overview
  - 2.1. Package template
  - 2.2. Group Package
  - 2.3. AD Profile
  - 2.4. WUA rules
  - 2.5. Self-Service Rules Package
  - 2.6. Host Agent Dynamic Configuration
- 3. Using different IDEs for developing WAPT packages
  - 3.1. Configuring WAPT to use supported IDEs
  - 3.2. Configuring WAPT to use a custom editor
- 4. How to code WAPT packages
  - 4.1. Simple examples of commonly used setuphelper functions
  - 4.2. Improving my package
- 5. Package structure detailed
  - 5.1. The control file
  - 5.2. The setup.py file
  - 5.3. The wapt.psproj file
  - 5.4. The icon.png file
  - 5.5. The manifest.sha256 file
  - 5.6. The signature file
  - 5.7. The certificate.crt file
  - 5.8. Other files
- 6. WAPT Setuphelpers apidoc
  - 6.1. Setuphelpers for Windows
  - 6.2. Setuphelpers for Linux
  - 6.3. Setuphelpers for macOS

Frequent problems and questions

- 1. FAQ - Guides
- 2. FAQ - Server Issues
  - 2.1. How to change correctly my CA (SSL/TLS) certificate
  - 2.2. What procedure should I follow if my WAPT server is inoperative (fire, flood, physical destruction)?
  - 2.3. WAPT Server behind a reverse proxy
  - 2.4. Resetting the WAPT Linux Server password
  - 2.5. Problems when enabling enable-check-certificate
  - 2.6. What can go wrong during the upgrades of WAPTserver ?
- 3. FAQ - Console Issues
  - 3.1. Error message about package on the WAPT Console
  - 3.2. Error message when opening the WAPT Console
  - 3.3. Managing the location of machines in WAPT: Updating the Organisation Unit (OU)
- 4. FAQ - Agent Issues
  - 4.1. I lost my WAPT private key
  - 4.2. My private key has been stolen
  - 4.3. Problems with registering a host with WAPT
  - 4.4. Windows does not wait for the network to be running on startup
  - 4.5. The WAPT Exit utility will not launch
  - 4.6. The WAPT Exit utility halts after 15 minutes and does not finish installing the WAPT packages
- 5. FAQ - Packages Issues
  - 5.1. Conflict between Wapt configuration and GPO
  - 5.2. I have deployed a software package on an organisation unit (OU), but I would like to exclude certain workstations
  - 5.3. Installation that needs a system reboot
  - 5.4. Updating WAPT packages from Python 2 to Python 3
  - 5.5. Wapt service crashes during install or remove
  - 5.6. Problems when creating a WAPT package
- 6. FAQ - Licences Issues
  - 6.1. Removing a WAPT licence
  - 6.2. License location
  - 6.3. License error
- 7. FAQ - System Environnement Issues
  - 7.1. My BIOS UUID bugs
  - 7.2. I have an issue with my proxy - THttpClientSocket.SockRecv(1) read = 0
  - 7.3. Frequent problems caused by Anti-Virus software
  - 7.4. The WAPT Deploy utility does not work
- 8. FAQ - Other Issues
  - 8.1. Known Issue: Diskpart failed (“hard drive not found”) on DELL computers
  - 8.2. How to move my repository to another partition
  - 8.3. Using a network drive to store and deliver WAPT packages
  - 8.4. Using the register() function in your audit scripts
  - 8.5. EWaptBadControl: ‘utf8’ codec can not decode byte
  - 8.6. I have a lot more hosts in the WAPT Console than I have host packages on my Server?
  - 8.7. I have removed the dependency but the package is still installed on my computer

Appendix

- Contacting Tranquil It
- Glossary
- Presentation of the security principles in WAPT
  - Preamble and definitions
  - Technical environment for product operation
  - Sensitive assets to be protected
  - Environmental measures
  - Threat description
  - Functions implemented by the product
  - Cover matrices
- Presentation of cryptographic processes
  - WAPT solution components and cryptographic mechanism specification
  - Nginx service
  - WAPT Server service
  - WAPT Agent
  - Local client applications: waptexit, waptself, wapttray
  - Initial WAPT Agent registration
  - Agent websocket connection
  - Agent login for inventory feedback
  - Connecting Agents to download packages
  - Server authentication by Agents
  - Authentication of deposit(s) by Agents
  - Remote actions on Agents
  - Administrator authentication on the WAPT Console
  - Signature of control file attributes
  - Signing WAPT packages
  - Microsoft Authenticode” signature for binaries and installers.
  - Checking the installer hash with waptdeploy
  - Signing requests sent to WAPT Agents
- Best pratices for packaging software (Software editors)
  - Environment variables
  - Program directories
  - Logs
  - Error codes
  - Printing
  - Distribution
  - Update
  - Version numbers
  - GPO
  - License dongles
  - Networking
  - PDFs
- WAPT release strategy
  - Release delay between the Enterprise and the Discovery versions
- Security bulletin
  - WAPT-2021-01 : CVE-2021-38608
- Changelog
  - WAPT-2.6 Serie
  - WAPT-2.5 Serie
  - WAPT-2.4 Serie
  - WAPT-2.3 Serie
  - WAPT-2.2 Serie
  - WAPT-2.1 Serie
  - WAPT-2.0 Serie
- WAPT End Users Licence Agreement
  - Definitions
  - Grant of rights
  - No derivative works
  - Ownership
  - Confidentiality
  - Disclaimer of warranties
  - Limitation of liability
  - Indemnification
  - Termination
  - Updates and support
- External component licences used in WAPT