We are pleased to announce Synex Server 13 R3, an update focused on system repository management. The main component of this version is synex-repo-manager, a tool developed to address a specific server administration problem: the safe and controlled incorporation of third-party repositories without compromising system stability.
synex-repo-manager: external repositories with judgment
Server administration frequently requires software that is not available in official Debian repositories. Docker, PostgreSQL with specific versions, monitoring stacks like Zabbix or Grafana: all legitimate use cases that demand additional repositories.
The traditional method involves manually adding APT sources, downloading GPG keys, and configuring signed-by entries. This process is error-prone: keys stored in incorrect locations, misconfigured sources, or worse yet, repositories added without signature verification that compromise system security.
synex-repo-manager addresses this by providing a managed workflow where repositories are pre-configured, GPG keys are verified and stored in appropriate locations, and all operations are reversible with complete cleanup.
Philosophy: control over automation
The tool is not an automatic repository aggregator. It does not scan the system looking for what to add, nor does it suggest repositories based on installed packages. It is an explicit selection tool: the administrator decides which repositories are needed, reviews them before applying changes, and can remove them completely when they are no longer needed.
This deliberate approach prevents system contamination with unnecessary sources. Each added repository is a conscious decision, not a side effect of installing software.
Staged workflow
synex-repo-manager implements a staged change system similar to version control:
Selection: the administrator searches and selects repositories from the available catalog. The search allows filtering by name or description, with automatic pagination when there are many results.
Review: before applying changes, the tool presents a complete summary of what will be added or removed. This includes source file names, GPG key locations, and repository components.
Execution: only after explicit confirmation, synex-repo-manager executes the changes: downloads verified GPG keys, creates source files with appropriate signed-by, and updates the package index.
This three-stage flow ensures that no surprising modifications occur to the system. The administrator has the opportunity to review and cancel at any point before changes become permanent.
Complete lifecycle management
A fundamental feature is the ability to remove repositories in a managed way. When a repository is no longer needed, synex-repo-manager can remove it completely:
- Removes the source file from
/etc/apt/sources.list.d/ - Deletes the GPG key from the keyring in
/usr/share/keyrings/ - Cleans any associated configuration
The tool only removes repositories that it added itself, identifying them through internal markers. This prevents accidental deletion of sources configured manually or by other methods.
Available repositories
The initial version includes definitions for repositories commonly required in server environments:
- Docker: Official Docker repository for Docker Engine, CLI, and related components installation on Debian Trixie.
- Grafana: Complete observability stack including Grafana, Prometheus, Loki, and related tools from the Grafana Labs ecosystem.
- PHP (Sury): Multiple PHP versions maintained by Ondřej Surý, allowing specific PHP versions not available in Debian stable to run.
- PostgreSQL (PGDG): Official PostgreSQL Global Development Group repository with updated database engine versions and extensions.
- Webmin: Web administration panel for Unix server management, with updates maintained by the Webmin project.
- Zabbix: Enterprise monitoring platform with server, agents, web frontend, and database components.
Each definition includes the repository URL, components (main, stable, etc.), supported architecture, verified GPG key, and detailed content description.
Internationalization
synex-repo-manager includes full internationalization support through gettext. The CLI interface is presented in the system’s configured language, with translations for error messages, prompts, and repository descriptions.
The repository catalog maintains descriptions in multiple languages, allowing administrators from different regions to understand the purpose of each source without consulting external documentation.
synex-installer: Synex Server’s comprehensive installer
Synex Server continues to include synex-installer, the installation tool developed in R2 that supports four filesystems with advanced enterprise configurations.
For administrators evaluating Synex Server for the first time, synex-installer provides:
- Complete ZFS: RAIDZ1/2/3 topologies, Mirror/RAID10, Stripe, with native AES-256-GCM encryption and automatic boot redundancy through synex-boot-redundancy
- Optimized BTRFS: pre-configured subvolumes with optional LUKS2 encryption
- Flexible ext4/XFS: interactive partitioning allowing simple configurations and optional LUKS2+LVM encryption
The installer allows deploying from simple single-disk configurations to multi-disk arrays with complete redundancy and encryption, all through an interactive workflow with validations at each step and backward navigation capability.
For complete technical information about synex-installer, its capabilities, and recommended use cases, see the PDF datasheet available here.
System updates
This version includes all cumulative package updates available in Debian Trixie repositories up to the build date. Critical security patches for server environments are incorporated, along with the optimized kernel for the amd64 architecture.
Availability
Synex Server 13 R3 is available for immediate download. As always, we recommend verifying checksums of downloaded images before creating the installation media.
Users of Synex Server 13 R2 can update through the standard package manager. For those who wish to install synex-repo-manager, they can do so via apt.
The incorporation of synex-repo-manager reinforces Synex Server’s approach toward management tools that prioritize control and traceability. Managing external repositories should not require custom scripts or error-prone manual configuration: it must be a managed, reversible, and auditable operation.
Download Synex Server 13 R3 from here.