From 277113d44ae6fd98decc75ea07a29c654bd0fc84 Mon Sep 17 00:00:00 2001 From: Michael Harp Date: Fri, 24 Apr 2026 14:14:52 -0400 Subject: [PATCH] Add dedicated landing page for OpenVox 8 docs Replace the release notes symlink at index.md with a standalone landing page that introduces OpenVox to new users: what it is, project history, operating modes, core packages, and getting-started links. Signed-off-by: Michael Harp --- docs/_openvox_8x/index.md | 36 +++++++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) mode change 120000 => 100644 docs/_openvox_8x/index.md diff --git a/docs/_openvox_8x/index.md b/docs/_openvox_8x/index.md deleted file mode 120000 index b5106bda0..000000000 --- a/docs/_openvox_8x/index.md +++ /dev/null @@ -1 +0,0 @@ -release_notes.markdown \ No newline at end of file diff --git a/docs/_openvox_8x/index.md b/docs/_openvox_8x/index.md new file mode 100644 index 000000000..c7c316077 --- /dev/null +++ b/docs/_openvox_8x/index.md @@ -0,0 +1,35 @@ +--- +layout: default +title: "OpenVox 8" +--- + +OpenVox is a community-maintained implementation of Puppet — a configuration management system for Linux, Unix, and Windows. It manages system state through a declarative language, compiling node-specific catalogs and enforcing them on each managed host. + +When Perforce discontinued public distribution of Puppet Open Source in late 2024, Overlook InfraTech stepped in with community packaging, and the project was subsequently adopted under [Vox Pupuli](https://voxpupuli.org/) stewardship as OpenVox. A Puppet Standards Steering Committee guides language and feature evolution going forward. + +OpenVox is downstream-compatible with Puppet Open Source — existing manifests, modules, Hiera data, and tooling work unchanged. + +## How it works + +OpenVox operates in two modes: + +**Agent/server** — Managed nodes run `openvox-agent` as a background service. Periodically, each agent sends facts (system inventory data) to an [OpenVox Server](../openvox-server/latest/), receives a compiled catalog, and enforces it. Results are reported back to the server. Communication is HTTPS with mutual TLS. + +**Standalone** — The `puppet apply` command compiles and applies a catalog locally, with no server required. + +## Core packages + +| Package | Contents | +|---|---| +| `openvox-agent` | OpenVox, OpenFact, Hiera, bundled Ruby and OpenSSL | +| `openvox-server` | JVM-based catalog server; depends on `openvox-agent` | + +See [Component versions in openvox-agent](about_agent.html) for exact version tables. + +## Getting started + +1. Review [system requirements](system_requirements.html) +2. Work through [pre-install tasks](install_pre.html) +3. Install on [Linux](install_linux.html), [Windows](install_windows.html), or [macOS](install_osx.html) + +For community help and a list of commercial support partners, see the [support page](https://voxpupuli.org/openvox/support/).