-
Notifications
You must be signed in to change notification settings - Fork 10
Modernize openvox-server landing page and nav #152
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
tuxmea
merged 4 commits into
OpenVoxProject:master
from
miharp:feat/modernize-openvox-server-index
May 6, 2026
Merged
Changes from 3 commits
Commits
Show all changes
4 commits
Select commit
Hold shift + click to select a range
9c0a5eb
Replace openvox-server index with modern landing page
miharp caa0986
Modernize openvox-server nav: remove Index entry, rebrand labels
miharp ebac153
Add Core packages section to openvox-server landing page
miharp 69f05c1
Rename 'Core packages' heading to 'OpenVox Server packages'
miharp File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,61 +1,33 @@ | ||
| --- | ||
| layout: default | ||
| title: "Puppet Server: Index" | ||
| canonical: "/puppetserver/latest/" | ||
| title: "OpenVox Server 8" | ||
| --- | ||
|
|
||
| Puppet Server is the next-generation application for managing Puppet agents. | ||
|
|
||
| > **Note:** For information about configuring and tuning settings specific to [Puppet Enterprise](https://puppet.com/docs/pe/), see | ||
| > [its documentation](https://puppet.com/docs/pe/latest/configuring/config_puppetserver.html). | ||
|
|
||
| - [**About OpenVox Server**](./services_puppetserver.html) | ||
| - [Release notes](./release_notes.html) | ||
| - [Deprecated features](./deprecated_features.html) | ||
| - [Notable differences vs. the Apache/Passenger stack](./puppetserver_vs_passenger.html) | ||
| - [Compatibility with Puppet agent](./compatibility_with_puppet_agent.html) | ||
| - [**Installing Puppet Server**](./install_from_packages.html) | ||
| - [**Configuring Puppet Server**](./configuration.html) | ||
| - [global.conf](./config_file_global.html) | ||
| - [webserver.conf](./config_file_webserver.html) | ||
| - [web-routes.conf](./config_file_web-routes.html) | ||
| - [puppetserver.conf](./config_file_puppetserver.html) | ||
| - [auth.conf](./config_file_auth.html) | ||
| - [Migrating deprecated authentication rules](./config_file_auth_migration.html) | ||
| - [metrics.conf](./config_file_metrics.html) | ||
| - [logback.xml](./config_file_logbackxml.html) | ||
| - [Advanced logging configuration](./config_logging_advanced.html) | ||
| - [master.conf](./config_file_master.html) (deprecated) | ||
| - [ca.conf](./config_file_ca.html) | ||
| - [Differing behavior in puppet.conf](./puppet_conf_setting_diffs.html) | ||
| - **Using and extending Puppet Server** | ||
| - [Subcommands](./subcommands.html) | ||
| - [Using Ruby gems](./gems.html) | ||
| - [Using an external certificate authority](./external_ca_configuration.html) | ||
| - [External SSL termination](./external_ssl_termination.html) | ||
| - [Monitoring Puppet Server metrics](./puppet_server_metrics.html) | ||
| - [HTTP client metrics](./http_client_metrics.html) | ||
| - [Tuning guide](./tuning_guide.html) | ||
| - [Applying metrics to improve performance](./puppet_server_metrics_performance.html) | ||
| - [Scaling Puppet Server](./scaling_puppet_server.html) | ||
| - [Restarting Puppet Server](./restarting.html) | ||
| - **Known issues and workarounds** | ||
| - [Known issues](./known_issues.html) | ||
| - [SSL problems with load-balanced PuppetDB servers ("Server Certificate Change" error)](./ssl_server_certificate_change_and_virtual_ips.html) | ||
| - **Administrative API endpoints** | ||
| - [Environment cache](./admin-api/v1/environment-cache.html) | ||
| - [JRuby pool](./admin-api/v1/jruby-pool.html) | ||
| - **Server-specific Puppet API endpoints** | ||
| - [Environment classes](./puppet-api/v3/environment_classes.html) | ||
| - [Environment modules](./puppet-api/v3/environment_modules.html) | ||
| - [Static file content](./puppet-api/v3/static_file_content.html) | ||
| - **Status API endpoints** | ||
| - [Status services](./status-api/v1/services.html) | ||
| - [Simple status](./status-api/v1/simple.html) | ||
| - **Metrics API endpoints** | ||
| - [v1 metrics](./metrics-api/v1/metrics_api.html) | ||
| - [v2 (Jolokia) metrics](./metrics-api/v2/metrics_api.html) | ||
| - **Developer information** | ||
| - [Debugging](./dev_debugging.html) | ||
| - [Running from source](./dev_running_from_source.html) | ||
| - [Tracing code events](./dev_trace_func.html) | ||
| OpenVox Server is the primary server component in an OpenVox agent/server deployment. | ||
| It compiles configuration catalogs for managed nodes, serves files, manages certificates, | ||
| and receives reports from agents. | ||
| It is a Ruby and Clojure application that runs on the Java Virtual Machine (JVM). | ||
|
|
||
| ## How it works | ||
|
|
||
| OpenVox agents periodically contact OpenVox Server over mutual-TLS HTTPS. | ||
| The server compiles a node-specific catalog from Puppet code and Hiera data, returns it | ||
| to the agent for enforcement, and collects the resulting report. | ||
| It also runs a built-in certificate authority for signing agent certificates. | ||
|
|
||
| For a full description of the service and its internal components, see | ||
| [About OpenVox Server](./services_puppetserver.html). | ||
|
|
||
| ## Core packages | ||
|
|
||
| | Package | Contents | | ||
| | ------- | -------- | | ||
| | `openvox-server` | JVM-based catalog server; depends on `openvox-agent`. Requires Java 17 or 21 (not bundled). | | ||
|
|
||
| ## Getting started | ||
|
|
||
| 1. Review [pre-install tasks](install_pre.html) — system requirements, DNS, firewall, and time synchronization | ||
| 2. [Install OpenVox Server](install_from_packages.html) | ||
| 3. [Configure OpenVox Server](configuration.html) | ||
|
|
||
| For community help and support resources, see the [Vox Pupuli support page](https://voxpupuli.org/openvox/support/). | ||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Was a bit confused by "core packages". Thought about Puppet Core in first place. Not sure how confusing/critical it is for others.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hum, fair point, "Server packages" better?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
or "OpenVox Server packages"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I prefer "OpenVox Server packages"