https://breatheoutbreathe.in/feeds/tags/p2p.xmlTag: p2p2026-07-23T21:34:52Zhttps://breatheoutbreathe.in/posts/mirror-worg-to-a-hyperdrive.htmlJoseph Turnercontact@breatheoutbreathe.in2024-12-16T12:00:00Z<p>During the Q&amp;A session of the <a href="https://emacsconf.org/2024/talks/hyperdrive/">EmacsConf 2024 hyperdrive.el talk</a>, Ihor Radchenko suggested using hyperdrive to distribute <a href="https://git.sr.ht/~bzg/worg/">worg</a>, the community-driven Org documentation written in Org format.</p> <p>Thanks, Ihor!</p> <h1>Mirror <code>worg</code> to a hyperdrive</h1> <p>You can run these commands on a local or remote machine. I chose to mirror <code>worg</code> to a hyperdrive on a remote Debian 12 VPS so that the content stays available when I turn off my computer.</p> <p>Install <code>git</code>, <code>dtach</code> and <a href="https://github.com/holepunchto/drives/">drives cli</a>:</p> <pre><code>sudo apt install git dtach npm npm install -g drives </code></pre> <p>Clone <code>worg</code>, then create a new corestore and hyperdrive:</p> <pre><code>git clone https://git.sr.ht/~bzg/worg/ cd worg drives init drives touch # Copy hyperdrive public key from output </code></pre> <p>Mirror the <code>worg</code> repository into the newly created hyperdrive:</p> <pre><code># drives mirror --dry-run . bpb1bq6sdfajw4bok7k9tdmrq153pbwzcyfkrqrfxw3hhihyddhy # Dry run first dtach -n /tmp/drives-worg-session drives mirror --live . bpb1bq6sdfajw4bok7k9tdmrq153pbwzcyfkrqrfxw3hhihyddhy # From output of `drives touch` </code></pre> <p>Note that <a href="https://github.com/holepunchto/drives/?tab=readme-ov-file#mirror-any-drive-into-another"><code>drives</code> ignores the <code>.git</code> folder</a> out of the box. Running the command inside a <code>dtach</code> session is a quick and dirty way to make the process persist after we've disconnected from the VPS. A better approach would be to write a service file to register the <code>drives</code> process with the init system (Debian 12 uses <code>systemd</code>).</p> <p>To automatically pull the latest changes from the remote <code>worg</code> repository, add a cronjob with <code>crontab -e</code>:</p> <pre><code>30 0 * * * git -C ~/worg pull </code></pre> <p>Voilá! <code>worg</code> is now continuously mirrored to a hyperdrive, which can be explored, linked to, transcluded, and more using <a href="https://ushin.org/hyperdrive/hyperdrive-manual.html">hyperdrive.el</a>:</p> <pre><code>hyper://bpb1bq6sdfajw4bok7k9tdmrq153pbwzcyfkrqrfxw3hhihyddhy/ </code></pre> <p>If you're viewing this file in Emacs with <code>hyperdrive.el</code> installed, follow this link to view the &quot;Introduction to Org-Mode and Worg&quot; in the hyperdrive mirror:</p> <pre><code>hyper://bpb1bq6sdfajw4bok7k9tdmrq153pbwzcyfkrqrfxw3hhihyddhy/index.org#%3A%3A%2AIntroduction%20to%20Org-Mode%20and%20Worg </code></pre> <p>I hope this helps you. Feel free to <a href="../contact.md">contact me</a> with suggestions, corrections, or questions!</p>