Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 18 additions & 6 deletions _layouts/default.html
Original file line number Diff line number Diff line change
Expand Up @@ -57,18 +57,19 @@
{% endfor %}
<script type="module" src="/assets/{{ entry.file }}"></script>
</head>
<body>
<body{% if page.pageId == 'home' %} class="is-home"{% endif %}>
<vox-header site-title="OpenVox" href="/">
<svg slot="logo" viewBox="0 0 2560 2478" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
<path d="M1946.22 272.18L1874.51 643.161C1840.69 625.335 1769.51 597.048 1744.63 592.202L1946.22 272.18ZM1647.05 893.509C1735.54 894.748 1789.05 935.815 1845.35 1010.52C1716.57 1047.71 1641.84 987.053 1586.85 899.704C1600.03 898.445 1634.39 893.339 1647.05 893.509ZM1421.62 600.655C1288.19 638.415 1170.91 730.251 1126.1 808.997C1126.1 808.997 1186.31 336.289 1244.88 158.652C1315.83 282.552 1421.62 600.655 1421.62 600.655ZM2477.39 1158.21C2342.39 1125.61 2074.76 1042.77 2053.7 881.139C2043.59 803.362 1980.86 717.271 1947.86 694.589L2004.72 106.064L1517.51 580.681C1517.51 580.681 1358.55 170.153 1243.89 0C1100.67 241.805 932.123 707.949 896.253 809.107L1227.33 1744.42C1243.68 1615.28 1328.09 1472.06 1428.27 1381.86C1350.61 1280.89 1210.56 1250.76 1151.7 1289.73C1228.31 1186.22 1376.21 1050.44 1651.27 1124.86C1773.51 1157.92 1898.72 1222.92 1978.75 1240.54C2184.12 1285.76 2337.81 1231.2 2337.81 1231.2C2336.23 1279.58 2360.5 1315.47 2410.61 1338.87C2196.05 1539.04 1914.11 1376.52 1715.51 1407.29C1514.8 1438.43 1238.87 2011.65 1201.73 2093.07L593.825 394.322L584.775 369.242C535.086 234.271 451.316 124.12 296.898 124.12H0V473.618H92.0793C145.649 473.618 170.849 489.355 189.769 542.882L903.123 2478H1248.99L1312.45 2324.93L1556.24 1812.6C1660.38 1581.57 1765.81 1518.18 2072.12 1531.73C2162.6 1535.73 2349.93 1537.27 2457.29 1405.96C2611.96 1216.8 2569.29 1180.38 2477.43 1158.16" fill="currentColor" />
</svg>
<a href="/"{% if page.pageId == 'home' %} aria-current="page"{% endif %}>Home</a>
<a href="/what-is-openvox.html"{% if page.pageId == 'what-is' %} aria-current="page"{% endif %}>What OpenVox Is</a>
<a href="/why-openvox.html"{% if page.pageId == 'why' %} aria-current="page"{% endif %}>Why OpenVox</a>
<a href="/products.html"{% if page.pageId == 'products' %} aria-current="page"{% endif %}>Products</a>
<a href="/why-openvox.html"{% if page.pageId == 'why' %} aria-current="page"{% endif %}>Why OpenVox</a>
<a href="/get-support.html"{% if page.pageId == 'get-support' %} aria-current="page"{% endif %}>Get Support</a>
<a href="/community.html"{% if page.pageId == 'community' %} aria-current="page"{% endif %}>Community</a>
<a href="/about.html"{% if page.pageId == 'about' %} aria-current="page"{% endif %}>About</a>

<vox-theme-toggle slot="actions"></vox-theme-toggle>
<vox-button slot="actions" href="#" size="sm">Get Started</vox-button>
<vox-button slot="actions" href="/get-started.html" size="sm">Get Started</vox-button>
</vox-header>

<main>
Expand All @@ -78,15 +79,26 @@
</main>

<vox-footer>
<vox-footer-column heading="Products">
<a href="/products/openvox.html">OpenVox</a>
<a href="/products/openvox-server.html">OpenVox Server</a>
<a href="/products/openvoxdb.html">OpenVoxDB</a>
<a href="/products/openfact.html">OpenFact</a>
<a href="/products/openbolt.html">OpenBolt</a>
<a href="/products/openvox-containers.html">OpenVox Containers</a>
</vox-footer-column>
<vox-footer-column heading="Project">
<a href="/what-is-openvox.html">What OpenVox Is</a>
<a href="/about.html">About</a>
<a href="/why-openvox.html">Why OpenVox</a>
<a href="/products.html">Products</a>
<a href="/get-started.html">Get Started</a>
<a href="/install.html">Installation Guide</a>
<a href="https://docs.openvoxproject.org/" target="_blank">Documentation</a>
<a href="/get-support.html">Get Support</a>
<a href="/vpat.html">Accessibility &amp; VPAT</a>
</vox-footer-column>
<vox-footer-column heading="Community">
<a href="/community.html">Join the Community</a>
<a href="https://github.com/OpenVoxProject">GitHub</a>
<a href="https://voxpupuli.org">Vox Pupuli</a>
<a href="https://voxpupuli.org/contributing/">Get Involved</a>
Expand Down
8 changes: 4 additions & 4 deletions what-is-openvox.html → about.html
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
pageId: what-is
title: "What OpenVox Is — OpenVox"
pageId: about
title: "About OpenVox — OpenVox"
description: "OpenVox is the community-maintained open source implementation of Puppet, forked and stewarded in the open by Vox Pupuli."
---
<vox-breadcrumbs class="vox-p-top-md">
<a href="/">Home</a>
<span aria-current="page">What is OpenVox</span>
<span aria-current="page">About</span>
</vox-breadcrumbs>

<vox-hero eyebrow="The Story" heading="Infrastructure automation, run by and for the community.">
Expand All @@ -16,7 +16,7 @@
actually use it.
</p>
<div slot="actions">
<vox-button href="#" variant="brand" class="vox-p-right-lg">Get Started</vox-button>
<vox-button href="/get-started.html" variant="brand" class="vox-p-right-lg">Get Started</vox-button>
<vox-cta href="/why-openvox.html">Why OpenVox</vox-cta>
</div>
</vox-hero>
Expand Down
88 changes: 88 additions & 0 deletions community.html
Original file line number Diff line number Diff line change
@@ -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."
---
<vox-breadcrumbs class="vox-p-top-md">
<a href="/">Home</a>
<span aria-current="page">Join the Community</span>
</vox-breadcrumbs>

<vox-hero eyebrow="Community" heading="Join the community.">
<p>
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.
</p>
<div slot="actions">
<vox-button href="https://short.voxpupu.li/puppetcommunity_slack_signup" variant="brand" target="_blank" class="vox-m-right-sm">Join Slack</vox-button>
<vox-cta href="https://github.com/OpenVoxProject" target="_blank">GitHub</vox-cta>
</div>
</vox-hero>

<section class="section">
<h2 class="section-heading">Talk with us</h2>
<vox-link-hub class="vox-m-top-md">
<vox-link-hub-item href="https://short.voxpupu.li/puppetcommunity_slack_signup" heading="Slack *">
<vox-icon slot="icon" name="chat" size="sm"></vox-icon>
Real-time chat with channels for OpenVox, individual modules, and community
organization. The most active channel.
</vox-link-hub-item>
<vox-link-hub-item href="https://web.libera.chat/?#voxpupuli" heading="IRC *">
<vox-icon slot="icon" name="terminal" size="sm"></vox-icon>
<code>#voxpupuli</code> on Libera.Chat, for anyone who'd rather not run another
chat app. Works right in the browser.
</vox-link-hub-item>
<vox-link-hub-item href="https://groups.io/g/voxpupuli/topics" heading="Mailing list">
<vox-icon slot="icon" name="bell" size="sm"></vox-icon>
Announcements, blog notifications, and official decision threads land here first.
</vox-link-hub-item>
<vox-link-hub-item href="https://github.com/OpenVoxProject" heading="GitHub">
<vox-icon slot="icon" name="github" size="sm"></vox-icon>
Where the code lives. File issues, open pull requests, and follow development
directly.
</vox-link-hub-item>
</vox-link-hub>
<div class="vox-m-top-sm vox-p-all-sm">
<span class="vox-ts-sm vox-color-gray-400">* We have an IRC bridge for Slack so you can use either.</span>
</div>
</section>

<section class="section">
<h2 class="section-heading">Get involved</h2>
<vox-link-hub class="vox-m-top-md">
<vox-link-hub-item href="https://voxpupuli.org/contributing/" heading="Contribute">
<vox-icon slot="icon" name="fork" size="sm"></vox-icon>
Browse open issues across the OpenVox and Vox Pupuli repositories and find
something that matches your interests.
</vox-link-hub-item>
<vox-link-hub-item href="https://voxpupuli.org/sponsoring/" heading="Sponsor">
<vox-icon slot="icon" name="heart" size="sm"></vox-icon>
Fund the CI/CD infrastructure and community work that keeps OpenVox running, via
Open Collective or GitHub Sponsors.
</vox-link-hub-item>
<vox-link-hub-item href="/get-support.html" heading="Get support">
<vox-icon slot="icon" name="help" size="sm"></vox-icon>
Need help rather than a way to help out? See free peer support and commercial
OpenVox partners.
</vox-link-hub-item>
</vox-link-hub>
</section>

<section class="section">
<h2 class="section-heading">Stay in the loop</h2>
<div class="vox-prose">
<p>
Track releases via RSS for
<a href="https://github.com/OpenVoxProject/openvox/releases.atom" target="_blank">OpenVox</a>,
<a href="https://github.com/OpenVoxProject/openvox-server/releases.atom" target="_blank">OpenVox Server</a>,
and
<a href="https://github.com/OpenVoxProject/openvoxdb/releases.atom" target="_blank">OpenVoxDB</a>.
Vox Pupuli also posts news on
<a href="https://fosstodon.org/@voxpupuli/" target="_blank">Mastodon</a>,
<a href="https://bsky.app/profile/voxpupuli.bsky.social/" target="_blank">Bluesky</a>,
<a href="https://www.linkedin.com/company/voxpupuli" target="_blank">LinkedIn</a>, and
<a href="https://www.reddit.com/r/Puppet/" target="_blank">Reddit</a>.
</p>
</div>
</section>
132 changes: 132 additions & 0 deletions get-started.html
Original file line number Diff line number Diff line change
@@ -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."
---
<vox-breadcrumbs class="vox-p-top-md">
<a href="/">Home</a>
<span aria-current="page">Get Started</span>
</vox-breadcrumbs>

<vox-hero eyebrow="Get Started" heading="Install OpenVox and see it hold state.">
<p>
This page is about getting OpenVox running, nothing else. Still deciding if it's the
right tool? Read <a href="/about.html">about OpenVox</a> or
<a href="/why-openvox.html">why teams choose it</a> first.
</p>
<div slot="actions">
<vox-button href="https://docs.openvoxproject.org/" variant="brand" target="_blank" class="vox-m-right-sm">Full Documentation</vox-button>
<vox-cta href="/get-support.html">Get Support</vox-cta>
</div>
</vox-hero>

<section class="section">
<h2 class="section-heading">Choose your path</h2>
<div class="vox-prose">
<p>
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.
</p>
</div>

<vox-grid class="card-grid" min="280px">
<vox-card heading="Standalone">
Install the agent, write a manifest, and apply it locally with
<code>puppet apply</code>. No server, no certificates, nothing to stand up first.
Good for trying OpenVox out or managing a single machine.
</vox-card>
<vox-card heading="Agent + Server">
Install <a href="/products/openvox-server.html">OpenVox Server</a> 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.
</vox-card>
</vox-grid>
</section>

<section class="section">
<h2 class="section-heading">Install the agent</h2>
<div class="vox-prose">
<p>
Packages are published at
<a href="https://apt.voxpupuli.org/" target="_blank">apt.voxpupuli.org</a> and
<a href="https://yum.voxpupuli.org/" target="_blank">yum.voxpupuli.org</a>. Both
commands below detect your release automatically.
</p>
</div>

<vox-tabs class="vox-m-top-md">
<vox-tab slot="tab" panel="deb" selected>Debian / Ubuntu</vox-tab>
<vox-tab slot="tab" panel="rpm">RHEL / EL</vox-tab>
<vox-tab-panel name="deb">
<pre class="code-block"><code>release="$(. /etc/os-release && echo "${ID}${VERSION_ID}")"
wget "https://apt.voxpupuli.org/openvox8-release-${release}.deb"
Comment thread
avitacco marked this conversation as resolved.
sudo dpkg -i "openvox8-release-${release}.deb"
sudo apt update
sudo apt install openvox-agent</code></pre>
</vox-tab-panel>
<vox-tab-panel name="rpm">
<pre class="code-block"><code>sudo rpm -Uvh "https://yum.voxpupuli.org/openvox8-release-el-$(rpm -E %rhel).noarch.rpm"
sudo yum install openvox-agent</code></pre>
</vox-tab-panel>
</vox-tabs>

<div class="vox-prose vox-m-top-lg">
<p>
That's the whole install. For prerequisites, connecting an agent to a server, and
Windows/macOS, see the <a href="/install.html">Installation Guide</a>.
</p>
</div>
</section>

<section class="section">
<h2 class="section-heading" id="try-it">Try it</h2>
<div class="vox-prose">
<p>With the agent installed, apply a manifest directly, no server required:</p>
</div>
<pre class="code-block vox-m-top-md"><code>puppet apply -e "notify { 'hello, world': }"</code></pre>
<div class="vox-prose vox-m-top-md">
<p>
From here, the
<a href="https://docs.openvoxproject.org/openvox/latest/quick_start_helloworld.html" target="_blank">Hello World quick start</a>
walks through writing a real module and applying it with an agent and server via
<code>puppet agent -t</code>.
</p>
</div>
</section>

<section class="section">
<h2 class="section-heading">Go further</h2>
<vox-link-hub class="vox-m-top-md">
<vox-link-hub-item href="https://forge.puppet.com/" heading="Bring your modules">
<vox-icon slot="icon" name="module" size="sm"></vox-icon>
Existing Puppet manifests, Hiera data, and Forge modules carry over unchanged.
Browse the Forge for thousands of ready-made ones.
</vox-link-hub-item>
<vox-link-hub-item href="/products.html" heading="Explore the product family">
<vox-icon slot="icon" name="blocks" size="sm"></vox-icon>
OpenVox Server, OpenVoxDB, OpenBolt, and container images for running the whole
stack.
</vox-link-hub-item>
<vox-link-hub-item href="https://docs.openvoxproject.org/" heading="Read the docs">
<vox-icon slot="icon" name="book" size="sm"></vox-icon>
Full reference documentation for every OpenVox product, kept in sync with each
release.
</vox-link-hub-item>
<vox-link-hub-item href="/get-support.html" heading="Get support">
<vox-icon slot="icon" name="help" size="sm"></vox-icon>
Free peer support from the community, plus commercial partners for training and
custom development.
</vox-link-hub-item>
</vox-link-hub>
</section>

<section class="section">
<vox-cta-band heading="Bring your fleet along.">
<p>Your manifests, modules, and workflows all carry over. Nothing to rewrite.</p>
<div slot="actions">
<vox-button href="https://docs.openvoxproject.org/" variant="brand" target="_blank">Full Documentation</vox-button>
<vox-button href="/community.html" variant="alt">Join the Community</vox-button>
</div>
</vox-cta-band>
</section>
8 changes: 3 additions & 5 deletions get-support.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,12 @@
<vox-hero eyebrow="Get Support" heading="Get help running OpenVox">
<p>
Vox Pupuli is an open source community group and offers no commercial support of its
own. For free, peer support, join the community on
<a href="https://short.voxpupu.li/puppetcommunity_slack_signup" target="_blank">Slack</a>
or see the other channels at
<a href="https://voxpupuli.org/connect/" target="_blank">voxpupuli.org/connect</a>.
own. For free, peer support, <a href="/community.html">join the community</a> on
Slack, IRC, or the mailing list.
</p>
<div slot="actions">
<vox-button href="https://docs.openvoxproject.org/" variant="brand" target="_blank" class="vox-m-right-sm">Documentation</vox-button>
<vox-cta href="https://short.voxpupu.li/puppetcommunity_slack_signup" target="_blank">Join the Community</vox-cta>
<vox-cta href="/community.html">Join the Community</vox-cta>
</div>
</vox-hero>

Expand Down
Loading