Skip to content

Release Notes v2.159

Jump to bottom
NeySlim edited this page Jun 4, 2026 · 2 revisions

Release Notes v2.159

Release Date: June 3, 2026

Overview

UCM v2.159 introduces CA-Template Pinning, a new feature that allows administrators to pin specific templates to Certificate Authorities for quick access during certificate issuance. This release also includes important security updates and bug fixes.

New Features

CA-Template Pinning (#118)

Pin templates to specific CAs for streamlined certificate workflows:

  • Quick Access: Pinned templates appear at the top of the template dropdown when issuing certificates
  • Visual Indicators: Pinned templates display with a pushpin icon
  • Flexible Management: Pin/unpin templates directly from the CA floating window
  • Show All Option: Toggle to view all available templates when needed

Use Cases:

  • Pin frequently used templates to production CAs
  • Separate development and production template sets
  • Reduce template selection errors by limiting visible options

How to Use:

  1. Open a CA's floating detail window
  2. Click the Manage Pins button in the action bar
  3. Select templates to pin from the modal
  4. When issuing certificates from that CA, pinned templates appear first

Migration 037: ca_template_pins Table

New database table to store CA-template pinning relationships:

  • Tracks which templates are pinned to which CAs
  • Supports both SQLite and PostgreSQL backends
  • Automatically applied during upgrade

Bug Fixes

  • FloatingDetailWindow Props: Fixed canWrite and canDelete props not being passed to DetailContent, preventing action buttons from displaying
  • Action Buttons Visibility: Fixed issue where Export, Manage Pins, Take Offline, and Delete buttons were not visible in CA floating windows
  • Icon Consistency: Replaced emoji with PushPin icon from phosphor-icons for better theme compatibility
  • i18n Interpolation: Fixed "Show all X templates" button to correctly display template count

Security Updates

Frontend Dependencies

Updated critical frontend dependencies to address security vulnerabilities:

  • engine.io-client: Fixed moderate severity vulnerability
  • picomatch: Fixed high severity vulnerability
  • brace-expansion: Fixed moderate severity vulnerability
  • @vitest/coverage-v8: Fixed critical severity vulnerability

All vulnerabilities were automatically resolved using npm audit fix.

Testing

Cross-Distro Validation

Validated on 6 configurations (3 distros × 2 backends):

Platform Backend Status
Debian (pve:8445) SQLite ✅ All tests passed
Debian (pve:8445) PostgreSQL ✅ All tests passed
Fedora (fedor:8443) SQLite ✅ All tests passed
Fedora (fedor:8443) PostgreSQL ✅ All tests passed
Docker (pve:8444) SQLite ✅ All tests passed
Docker (pve:8444) PostgreSQL ✅ All tests passed

Test Coverage

  • Smoke Tests: 13/13 passed across all platforms
  • Use Case Tests: 11-12/12 passed (UC9 fails on empty databases as expected)
  • Migration Tests: All 37 migrations validated on both backends

Installation

Debian/Ubuntu (DEB)

wget https://github.com/NeySlim/ultimate-ca-manager/releases/download/v2.159/ucm_2.159_all.deb
sudo dpkg -i ucm_2.159_all.deb
sudo systemctl restart ucm

Fedora/RHEL (RPM)

wget https://github.com/NeySlim/ultimate-ca-manager/releases/download/v2.159/ucm-2.159-1.fc43.noarch.rpm
sudo dnf install ucm-2.159-1.fc43.noarch.rpm
sudo systemctl restart ucm

Docker

docker pull ghcr.io/neyslim/ultimate-ca-manager:2.159
docker run -d -p 8443:8443 ghcr.io/neyslim/ultimate-ca-manager:2.159

Upgrade Notes

From v2.158 or Earlier

  • Migration 037 will automatically create the ca_template_pins table
  • No manual intervention required
  • Existing templates and CAs remain unchanged
  • No template pins are created by default (pin templates manually as needed)

Database Compatibility

  • ✅ SQLite: Fully supported
  • ✅ PostgreSQL: Fully supported
  • Migration tested on both backends

Documentation Updates

  • Certificate Templates: Added section on Template Pinning
  • API Documentation: Updated with new pinning endpoints
  • CA Management: Documented Manage Pins button in floating window

🐳 Docker

Official Docker image available:

  • ghcr.io/neyslim/ultimate-ca-manager:2.159
  • Multi-architecture support (amd64, arm64)

Links

← Release Notes v2.155 | Home

Clone this wiki locally