diff --git a/community.html b/community.html
new file mode 100644
index 0000000..21d9e81
--- /dev/null
+++ b/community.html
@@ -0,0 +1,88 @@
+---
+pageId: community
+title: "Join the Community — OpenVox"
+description: "Ways to connect with the OpenVox and Vox Pupuli community: Slack, IRC, mailing lists, GitHub, contributing, and sponsoring."
+---
+
+ Home
+ Join the Community
+
+
+
+
+ OpenVox is stewarded in the open by Vox Pupuli. Decisions happen in public channels,
+ not behind closed doors, and anyone can take part. Pick whichever fits how you like
+ to communicate.
+
+
+ Join Slack
+ GitHub
+
+
+
+
+
Talk with us
+
+
+
+ Real-time chat with channels for OpenVox, individual modules, and community
+ organization. The most active channel.
+
+
+
+ #voxpupuli on Libera.Chat, for anyone who'd rather not run another
+ chat app. Works right in the browser.
+
+
+
+ Announcements, blog notifications, and official decision threads land here first.
+
+
+
+ Where the code lives. File issues, open pull requests, and follow development
+ directly.
+
+
+
+ * We have an IRC bridge for Slack so you can use either.
+
+
+
+
+
Get involved
+
+
+
+ Browse open issues across the OpenVox and Vox Pupuli repositories and find
+ something that matches your interests.
+
+
+
+ Fund the CI/CD infrastructure and community work that keeps OpenVox running, via
+ Open Collective or GitHub Sponsors.
+
+
+
+ Need help rather than a way to help out? See free peer support and commercial
+ OpenVox partners.
+
+
+
+
+
+
+
diff --git a/get-started.html b/get-started.html
new file mode 100644
index 0000000..01b65d4
--- /dev/null
+++ b/get-started.html
@@ -0,0 +1,132 @@
+---
+pageId: get-started
+title: "Get Started — OpenVox"
+description: "Install OpenVox and get your first node under management: agent install for Debian/Ubuntu and RHEL, a local test run, and where to go next."
+---
+
+ Home
+ Get Started
+
+
+
+
+ This page is about getting OpenVox running, nothing else. Still deciding if it's the
+ right tool? Read about OpenVox or
+ why teams choose it first.
+
+
+ Full Documentation
+ Get Support
+
+
+
+
+
Choose your path
+
+
+ OpenVox runs standalone on a single machine, or as an agent checking in with a
+ central server across a fleet. Pick whichever matches what you're doing today — it's
+ easy to add a server later without redoing any of your code.
+
+
+
+
+
+ Install the agent, write a manifest, and apply it locally with
+ puppet apply. No server, no certificates, nothing to stand up first.
+ Good for trying OpenVox out or managing a single machine.
+
+
+ Install OpenVox Server and point agents
+ at it. Agents check in on a schedule, pull their catalog, and report back, so drift
+ gets corrected without anyone running anything by hand.
+
+
+
+
+
+
+ That's the whole install. For prerequisites, connecting an agent to a server, and
+ Windows/macOS, see the Installation Guide.
+
+
+
+
+
+
Try it
+
+
With the agent installed, apply a manifest directly, no server required:
+
+
puppet apply -e "notify { 'hello, world': }"
+
+
+ From here, the
+ Hello World quick start
+ walks through writing a real module and applying it with an agent and server via
+ puppet agent -t.
+
+
+
+
+
+
Go further
+
+
+
+ Existing Puppet manifests, Hiera data, and Forge modules carry over unchanged.
+ Browse the Forge for thousands of ready-made ones.
+
+
+
+ OpenVox Server, OpenVoxDB, OpenBolt, and container images for running the whole
+ stack.
+
+
+
+ Full reference documentation for every OpenVox product, kept in sync with each
+ release.
+
+
+
+ Free peer support from the community, plus commercial partners for training and
+ custom development.
+
+
+
+
+
+
+
Your manifests, modules, and workflows all carry over. Nothing to rewrite.
Vox Pupuli is an open source community group and offers no commercial support of its
- own. For free, peer support, join the community on
- Slack
- or see the other channels at
- voxpupuli.org/connect.
+ own. For free, peer support, join the community on
+ Slack, IRC, or the mailing list.
Documentation
- Join the Community
+ Join the Community
diff --git a/index.html b/index.html
index 3564ba0..7e8c267 100644
--- a/index.html
+++ b/index.html
@@ -11,69 +11,13 @@
actually use it.
- Get Started
- Read the Story
+ Get Started
+ Read the Story
-
-
-
- For nearly two decades, Puppet defined what configuration management could be. In
- late 2024, its corporate owner moved development behind closed doors and attached
- licensing terms that put open access out of reach for the community that had
- sustained the project for years.
-
-
- So Vox Pupuli, the collective of longtime Puppet module and tooling maintainers,
- forked the last truly open releases and kept going. That fork is OpenVox.
-
-
- Read the full story
-
-
-
-
-
-
+
+
+
+
+
+ For nearly two decades, Puppet defined what configuration management could be. In
+ late 2024, its corporate owner moved development behind closed doors and attached
+ licensing terms that put open access out of reach for the community that had
+ sustained the project for years.
+
+
+ So Vox Pupuli, the collective of longtime Puppet module and tooling maintainers,
+ forked the last truly open releases and kept going. That fork is OpenVox.
+
+
+ Read the full story
+
+
+
+
Install OpenVox in minutes and bring your existing Puppet code with you.
- Installation Guide
- Join the Community
+ Installation Guide
+ Join the Community
diff --git a/install.html b/install.html
new file mode 100644
index 0000000..8d8ac5f
--- /dev/null
+++ b/install.html
@@ -0,0 +1,179 @@
+---
+pageId: install
+title: "Installation Guide — OpenVox"
+description: "Step-by-step OpenVox agent installation: prerequisites, adding the package repository, installing on Debian, Ubuntu, RHEL, and other EL distributions, and getting the agent checked in."
+---
+
+ Home
+ Installation Guide
+
+
+
+
+ A full walkthrough: prerequisites, adding the package repository, installing, and
+ getting the agent checked in. Looking for the two-command version instead? See
+ Get Started.
+
+
+ Full Documentation
+ Get Started
+
+
+
+
+
Before you begin
+
+
+
+ Pick a deployment model. Standalone (puppet apply,
+ no server) or agent-server (agents check in on a schedule). See the
+ architecture overview
+ if you're unsure which fits.
+
+
+ Check system requirements. Confirm your OS and node counts are
+ within OpenVox's
+ tested platforms and sizing.
+
+
+ Migrating from Puppet? Back up /etc/puppetlabs/
+ first, especially on the server. OpenVox packages reuse that same directory
+ structure, and OpenVox can't run alongside an existing Puppet install.
+
+
+ Networking. Agents need to reach the server on port 8140, and
+ forward/reverse DNS should resolve correctly for every node.
+
+
+ Time sync. Certificate issuance depends on accurate system
+ clocks — make sure NTP (or similar) is running before agents request
+ certificates.
+
+
+
+
+
+ Install and validate OpenVox Server
+ first, before rolling the agent out to managed nodes. Running standalone? Skip
+ straight to the install steps below.
+
+
+
+
+
+
+
+
+
+ See the full
+ Windows
+ and
+ macOS
+ install guides, or the
+ full Linux guide
+ for distributions not covered above.
+
+
+
+
+
Confirm the executables are on PATH
+
+
+ OpenVox installs to /opt/puppetlabs/bin, which usually isn't on
+ PATH by default. Add it for the current session, and to your shell
+ profile if you want it to stick:
+
+
+
export PATH=/opt/puppetlabs/bin:$PATH
+
+
+
+
Point the agent at your server
+
+
+ Running agent-server and your server isn't reachable at the hostname
+ puppet? Set it explicitly in
+ /etc/puppetlabs/puppet/puppet.conf:
+
+
+
[main]
+server = puppet.example.com
+
+
+ Running standalone with puppet apply, or your server really is
+ reachable as puppet? Skip this step.
+
+
+
+
+
+
Start and enable the service
+
sudo /opt/puppetlabs/bin/puppet resource service puppet ensure=running enable=true
+
+
+
+
Run a test check-in
+
sudo /opt/puppetlabs/bin/puppet agent --test
+
+
+ On agent-server, the first run generates a certificate signing request. If your
+ server requires manual signing, sign it on the CA:
+
+
+
sudo /opt/puppetlabs/bin/puppetserver ca list
+sudo /opt/puppetlabs/bin/puppetserver ca sign --certname <NAME>
+
+
Then re-run the test check-in on the node.
+
+
+
+
+
What's next
+
+
+
+ Apply a manifest locally with puppet apply, no server required.
+
+
+
+ Manage Puppet code across your infrastructure with r10k and write your first
+ module.
+
+
+
+
+
+
+
Your manifests, modules, and workflows all carry over. Nothing to rewrite.
+
+ Full Documentation
+ Join the Community
+
+
+
diff --git a/openvox-vs-ansible.html b/openvox-vs-ansible.html
index 298cd20..9cee9b9 100644
--- a/openvox-vs-ansible.html
+++ b/openvox-vs-ansible.html
@@ -17,7 +17,7 @@
remembers to.
- Get Started
+ Get StartedWhy OpenVox
@@ -125,8 +125,8 @@
Where Ansible is the better fit
Install OpenVox in minutes and bring your existing Puppet code with you.
- Installation Guide
- Join the Community
+ Installation Guide
+ Join the Community