This commit is contained in:
Raven Scott
2026-07-11 19:07:07 -04:00
parent acc2042f82
commit 2690f6a262
3 changed files with 85 additions and 80 deletions
+5 -80
View File
@@ -87,89 +87,14 @@ sudo journalctl -u peardock -f
<li><strong>macOS:</strong> <code>peardock.app</code> under <code>~/Applications</code> (clears quarantine via <code>xattr</code>)</li> <li><strong>macOS:</strong> <code>peardock.app</code> under <code>~/Applications</code> (clears quarantine via <code>xattr</code>)</li>
<li><strong>Linux:</strong> binary under <code>~/.local/share/peardock</code>, symlink in <code>~/.local/bin</code>, desktop entry</li> <li><strong>Linux:</strong> binary under <code>~/.local/share/peardock</code>, symlink in <code>~/.local/bin</code>, desktop entry</li>
</ul> </ul>
</div>
</div>
<div class="container">
<div class="download-grid">
<div class="download-card">
<h3>🖥 peardock-server</h3>
<p>Bare standalone HyperDHT control plane. Run on the host with Docker. Identity from <code>SERVER_SEED</code> / <code>.env</code>.</p>
<p class="text-muted" style="font-size: 0.85rem;">Asset pattern: <code>peardock-server-VERSION-HOST.tar.gz</code></p>
<div class="platform-list">
<div class="platform-row"><span>linux-x64</span><span class="badge-muted badge">.tar.gz</span></div>
<div class="platform-row"><span>linux-arm64</span><span class="badge-muted badge">.tar.gz</span></div>
<div class="platform-row"><span>darwin-x64</span><span class="badge-muted badge">.tar.gz</span></div>
<div class="platform-row"><span>darwin-arm64</span><span class="badge-muted badge">.tar.gz</span></div>
<div class="platform-row"><span>win32-x64</span><span class="badge-muted badge">.tar.gz</span></div>
<div class="platform-row"><span>win32-arm64</span><span class="badge-muted badge">.tar.gz</span></div>
</div>
</div>
<div class="download-card">
<h3>⌘ peardock-client</h3>
<p>Desktop GUI (Electron). Connect with the server public key. Multi-peer fleet, tunnels, terminals, deploy wizard.</p>
<p class="text-muted" style="font-size: 0.85rem;">Asset pattern: <code>peardock-client-VERSION-HOST.tar.gz</code></p>
<div class="platform-list">
<div class="platform-row"><span>linux-x64</span><span class="badge-muted badge">.tar.gz</span></div>
<div class="platform-row"><span>linux-arm64</span><span class="badge-muted badge">.tar.gz</span></div>
<div class="platform-row"><span>darwin-x64</span><span class="badge-muted badge">.app in tar</span></div>
<div class="platform-row"><span>darwin-arm64</span><span class="badge-muted badge">.app in tar</span></div>
<div class="platform-row"><span>win32-x64</span><span class="badge-muted badge">.tar.gz</span></div>
<div class="platform-row"><span>win32-arm64</span><span class="badge-muted badge">.tar.gz</span></div>
</div>
</div>
</div>
<div class="card" style="max-width: 900px; margin: 0 auto 4rem;">
<h3 class="mb-4">Manual download</h3>
<p class="text-muted mb-4" style="font-size: 0.95rem;">
Browse all assets on the
<a href="https://git.ssh.surf/snxraven/peardock/releases/tag/rolling" target="_blank" rel="noopener">rolling</a>
release. Each tarball has a sibling <code>.sha256</code> checksum.
</p>
<pre><code># Example: Linux x64 server
curl -fLO https://git.ssh.surf/snxraven/peardock/releases/download/rolling/peardock-server-2.0.1-linux-x64.tar.gz
curl -fLO https://git.ssh.surf/snxraven/peardock/releases/download/rolling/peardock-server-2.0.1-linux-x64.tar.gz.sha256
sha256sum -c peardock-server-*.sha256
tar -xzf peardock-server-*.tar.gz
# → peardock-server binary</code></pre>
</div>
<div class="card" style="max-width: 900px; margin: 0 auto 4rem;">
<h3 class="mb-4">Build from source</h3>
<pre><code>git clone https://git.ssh.surf/snxraven/peardock.git
cd peardock
npm ci
npm run server # control plane (needs Docker socket)
npm run start:client # Electron GUI
# or
npm run make # all 64-bit server + client hosts → out/</code></pre>
<p class="mt-4 text-muted" style="font-size: 0.92rem;"> <p class="mt-4 text-muted" style="font-size: 0.92rem;">
Node.js ≥ 20 required. See <a href="docs/quickstart.html">Quick start</a> and For binary downloads by platform, checksums, and release notes, see
<a href="docs/operator.html">Operator guide</a> for production. <a href="/releases">Releases</a>.
Source builds and production ops are in
<a href="/docs/quickstart">Quick start</a> and
<a href="/docs/operator">Operator guide</a>.
</p> </p>
</div> </div>
<div class="callout warn" style="max-width: 900px; margin: 0 auto 4rem;">
<div class="callout-icon">!</div>
<div class="callout-body">
<strong>macOS Gatekeeper.</strong> Darwin clients from Linux CI are ad-hoc signed.
If the app is blocked: right-click → Open, or
<code>xattr -cr ~/Applications/peardock.app</code>.
Developer ID re-sign: <code>npm run sign:macos -- out/peardock-darwin-arm64/peardock.app</code>
</div>
</div>
<div class="callout info" style="max-width: 900px; margin: 0 auto 4rem;">
<div class="callout-icon">i</div>
<div class="callout-body">
<strong>Docker access on the server.</strong> The service user <code>peardock</code> must reach
<code>/var/run/docker.sock</code> (usually group <code>docker</code>, mode 660).
The installer adds <code>peardock</code> to that group. If stats/start fail with permission errors:
<code>sudo usermod -aG docker peardock && sudo systemctl restart peardock</code>
(and restart Docker if the group was just created).
</div>
</div>
</div> </div>
<div data-footer data-prefix=""></div> <div data-footer data-prefix=""></div>
+53
View File
@@ -27,6 +27,7 @@
Binaries and notes published at Binaries and notes published at
<a href="https://git.ssh.surf/snxraven/peardock/releases" target="_blank" rel="noopener">git.ssh.surf/snxraven/peardock/releases</a>. <a href="https://git.ssh.surf/snxraven/peardock/releases" target="_blank" rel="noopener">git.ssh.surf/snxraven/peardock/releases</a>.
The <strong>rolling</strong> tag is the recommended install channel. The <strong>rolling</strong> tag is the recommended install channel.
Prefer the one-line installer on the <a href="/download">download page</a> when you can.
</p> </p>
<div class="flex flex-wrap gap-3 releases-hero-actions"> <div class="flex flex-wrap gap-3 releases-hero-actions">
<a class="btn btn-primary" href="/download">Install guide</a> <a class="btn btn-primary" href="/download">Install guide</a>
@@ -37,6 +38,58 @@
</section> </section>
<div class="container releases-page"> <div class="container releases-page">
<div class="releases-about card">
<h2 class="mb-4">What you will find</h2>
<div class="download-grid" style="margin-bottom: 1.25rem;">
<div>
<h3 class="mb-2">peardock-server</h3>
<p class="text-muted" style="font-size: 0.92rem; margin-bottom: 0.75rem;">
Bare HyperDHT control plane for the Docker host. Identity from <code>SERVER_SEED</code> / <code>.env</code>.
</p>
<p class="text-muted" style="font-size: 0.85rem; margin: 0;">
Pattern: <code>peardock-server-VERSION-HOST.tar.gz</code>
</p>
</div>
<div>
<h3 class="mb-2">peardock-client</h3>
<p class="text-muted" style="font-size: 0.92rem; margin-bottom: 0.75rem;">
Desktop GUI (Electron). Connect with the server public key. macOS tarballs include a <code>.app</code>.
</p>
<p class="text-muted" style="font-size: 0.85rem; margin: 0;">
Pattern: <code>peardock-client-VERSION-HOST.tar.gz</code>
</p>
</div>
</div>
<p class="text-muted" style="font-size: 0.92rem; margin-bottom: 0.75rem;">
<strong>Hosts (64-bit):</strong>
linux-x64, linux-arm64, darwin-x64, darwin-arm64, win32-x64, win32-arm64.
Each tarball has a sibling <code>.sha256</code> checksum. Filter below by server, client, or checksums.
</p>
<pre style="margin-bottom: 1rem;"><code># Manual example (Linux x64 server). Use the exact filename from a release below.
curl -fLO https://git.ssh.surf/snxraven/peardock/releases/download/rolling/peardock-server-VERSION-linux-x64.tar.gz
curl -fLO https://git.ssh.surf/snxraven/peardock/releases/download/rolling/peardock-server-VERSION-linux-x64.tar.gz.sha256
sha256sum -c peardock-server-*.sha256
tar -xzf peardock-server-*.tar.gz</code></pre>
<div class="callout warn" style="margin-bottom: 1rem;">
<div class="callout-icon">!</div>
<div class="callout-body">
<strong>macOS Gatekeeper.</strong> Darwin clients from Linux CI are ad-hoc signed.
If the app is blocked: right-click → Open, or
<code>xattr -cr ~/Applications/peardock.app</code>.
Developer ID re-sign from a source build:
<code>npm run sign:macos -- out/peardock-darwin-arm64/peardock.app</code>
</div>
</div>
<p class="text-muted" style="font-size: 0.92rem; margin: 0;">
<strong>Build from source:</strong>
clone the repo, use Node.js ≥ 20, then <code>npm ci</code>,
<code>npm run server</code> / <code>npm run start:client</code>, or
<code>npm run make</code> for all host binaries.
Details in <a href="/docs/quickstart">Quick start</a> and
<a href="/docs/release">Release docs</a>.
</p>
</div>
<div class="releases-toolbar"> <div class="releases-toolbar">
<div class="releases-filters" role="group" aria-label="Filter assets"> <div class="releases-filters" role="group" aria-label="Filter assets">
<button type="button" class="releases-filter is-active" data-filter="all">All assets</button> <button type="button" class="releases-filter is-active" data-filter="all">All assets</button>
+27
View File
@@ -34,6 +34,33 @@
box-sizing: border-box; box-sizing: border-box;
} }
.releases-about {
margin-bottom: 1.75rem;
padding: 1.35rem 1.4rem 1.4rem;
}
.releases-about h2 {
font-size: 1.15rem;
font-weight: 700;
letter-spacing: -0.02em;
margin: 0 0 1rem;
}
.releases-about h3 {
font-size: 0.98rem;
font-weight: 650;
margin: 0;
}
.releases-about .download-grid {
gap: 1rem;
}
.releases-about pre {
font-size: 0.8rem;
margin: 0 0 1rem;
}
.releases-toolbar { .releases-toolbar {
display: flex; display: flex;
flex-wrap: wrap; flex-wrap: wrap;