Dwarfguard versions, available releases and release policy
Dwarfguard 1.0.0 was released at the end of 2024. It is
- Production ready up to mid-large deployments (tested up to 40000 devices, namespace for up to 65000 devices)
- Feature-ready for many Monitoring-Alerting-Management use cases and some Automation use cases.
- Supports these device types:
- Advantech cellular routers (ICR OS)
- Teltonika cellular routers (RutOS)
- Generic Linux OS boxes (servers, desktops, notebooks, routers, ... actual support depends case by case)
- OpenWRT devices
- Provides Automatic Agent Deployment - a script for parallel automated mass installation onto many devices.
As for the server, the supported OS is Debian GNU/Linux 12. See more in the Installing Dwarfguard.
Below you can find the overview of released and planned versions, together with description of releasing policy and basic release test set that is checked against every production release of Dwarfguard.
Dwarfguard versions table
| Version | Availability | Support | Audience | Release date | Release page |
|---|---|---|---|---|---|
| 1.0.2 | Actual | Supported | General | 2025-05-05 | Link |
| 1.0.1 | Obsolete | Supported | General | 2025-03-05 | Link |
| 1.0.0 | Obsolete | Supported | General | 2024-12-23 | Link |
| 0.8.2 | Obsolete | Supported | General | 2024-06-07 | Link |
| 0.8.1 | No | EOL | General | 2024-03-10 | Link |
| 0.8.0 | No | EOL | General | 2023-11-15 | Link |
| 0.7.4 | No | EOL | Early customers | 2023-06-26 | Link |
| 0.7.3 | No | EOL | Early customers | 2023-04-15 | Link |
| 0.7.2 | No | EOL | Early customers | 2023-03-01 | Link |
| 0.7.1 | No | EOL | Early customers | 2023-01-24 | Link |
| 0.7.0 | No | EOL | Early customers | 2023-01-15 | Link |
| 0.6.1 | No | EOL | Early customers | 2022-12-06 | Link |
| 0.6.0 | No | EOL | Early customers | 2022-10-30 | Link |
| 0.5.0 | No | EOL | Beta testers | 2022-02-17 | |
| 0.4.0 | No | EOL | Beta testers | 2021-12-12 |
Dwarfguard versions roadmap
| Version | Brand | Type | Planned date |
|---|---|---|---|
| 1.0.x | DT | Support of 1.0 | until 1.1.0 |
| 1.1.0 | DT | Feature | 1H / 2025 |
Dwarfguard versioning policy
Dwarfguard follows a typical versioning scheme. Each version is composed of three numbers, first being called major release number, second minor release number and the last patchlevel (the term bugfix version is common as well).
If a need arise to distinguish between different builds of one release, a fourth number (build number) is added as well. In the logs, you can see the 1.2.3 release version mentioned as 1.2.3.0 typically.
- major brings major features and major changes to the system. The current major is 1 since end of 2024 (before, the 0.x versions were released). The major version is not released often.
- minor is typically a version that brings improved features and also a new ones, but it is not revolutionary. Upgrading to a new minor version could incorporate some downtime and it could also result in a need of configuration changes depending on the amount and size of changes included. You may stay on the minor version as long as it is supported while still getting the security fixes.
- patchlevel covers bringing bugfixes and security fixes. A license for any version (even if bound only to the minor version) always includes upgrade to any security/bugfix release.
- build number is set to 0 on the first build and usually not mentioned. In general, there is only one build per release. One of the potential reasons to publish another build for the same release version is to fix a textual typo on a visible place or wrong picture included in the build.
Dwarfguard release policy
Next to the automatic development testing, every release must pass release testing. Release testing differs to the regular testing in few aspects:
- is done on production deployment, not development deployment
- testing includes manual confirmation that all end-to-end scenarios are working
- includes upgrade testing for both single-deploy and multi-deploy cases
The testing scenarios may be split into several areas:
- Deployment testing
- Tests ability to deploy on all supported deploy platforms, verification that deployed finishes correctly.
- Setup testing
- Verifies that all startup configuration can be executed and that the resulting configuration behaves as expected.
- Agent-device compatibility testing
- Tests that new devices can be added to the system using the released versions of agents and respective agents functionality including all data send and received in the system.
- Upgrade testing
- Tests that upgrade path from the previous to actual release is supported and data are migrated correctly.
- Tests that old agents can upgrade to new agents.
- End-to-end scenario testing
- Aims to verify particular functionality by executing defined end-to-end scenario test.
- Performance testing
- Verifies that Dwarfguard performance is acceptable for production usage and provides comparison of different setups.
- Performance testing is not performed for every release.
Follow to Testing if interested to read more information or check out performance testing results or recommended HW/setup for particular Dwarfguard version and number of devices.