diff options
Diffstat (limited to 'news/packaging-archlinux/index.html')
| -rw-r--r-- | news/packaging-archlinux/index.html | 123 |
1 files changed, 123 insertions, 0 deletions
diff --git a/news/packaging-archlinux/index.html b/news/packaging-archlinux/index.html new file mode 100644 index 0000000..043464f --- /dev/null +++ b/news/packaging-archlinux/index.html @@ -0,0 +1,123 @@ +<!DOCTYPE html> +<html lang="en"> +<head> + <meta charset="utf-8"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <title>Packaging Tesseras for Arch Linux — Tesseras</title> + <meta name="description" content="How to build and install the Tesseras package on Arch Linux from source using makepkg."> + <!-- Open Graph --> + <meta property="og:type" content="article"> + <meta property="og:title" content="Packaging Tesseras for Arch Linux"> + <meta property="og:description" content="How to build and install the Tesseras package on Arch Linux from source using makepkg."> + <meta property="og:image" content="https://tesseras.net/images/social.jpg"> + <meta property="og:image:width" content="1200"> + <meta property="og:image:height" content="630"> + <meta property="og:site_name" content="Tesseras"> + <!-- Twitter Card --> + <meta name="twitter:card" content="summary_large_image"> + <meta name="twitter:title" content="Packaging Tesseras for Arch Linux"> + <meta name="twitter:description" content="How to build and install the Tesseras package on Arch Linux from source using makepkg."> + <meta name="twitter:image" content="https://tesseras.net/images/social.jpg"> + <link rel="stylesheet" href="https://tesseras.net/style.css?h=21f0f32121928ee5c690"> + + + <link rel="alternate" type="application/atom+xml" title="Tesseras" href="https://tesseras.net/atom.xml"> + + + <link rel="icon" type="image/png" sizes="32x32" href="https://tesseras.net/images/favicon.png?h=be4e123a23393b1a027d"> + +</head> +<body> + <header> + <h1> + <a href="https://tesseras.net/"> + <img src="https://tesseras.net/images/logo-64.png?h=c1b8d0c4c5f93b49d40b" alt="Tesseras" width="40" height="40" class="logo"> + Tesseras + </a> + </h1> + <nav> + + <a href="https://tesseras.net/about/">About</a> + <a href="https://tesseras.net/news/">News</a> + <a href="https://tesseras.net/releases/">Releases</a> + <a href="https://tesseras.net/faq/">FAQ</a> + <a href="https://tesseras.net/subscriptions/">Subscriptions</a> + <a href="https://tesseras.net/contact/">Contact</a> + + </nav> + <nav class="lang-switch"> + + <strong>English</strong> | <a href="/pt-br/news/packaging-archlinux/">Português</a> + + </nav> + </header> + + <main> + +<article> + <h2>Packaging Tesseras for Arch Linux</h2> + <p class="news-date">2026-02-16</p> + <p>Tesseras now ships a PKGBUILD for Arch Linux. This post walks through building +and installing the package from source.</p> +<h2 id="prerequisites">Prerequisites</h2> +<p>You need a working Rust toolchain and the base-devel group:</p> +<pre><code data-lang="sh">sudo pacman -S --needed base-devel sqlite +rustup toolchain install stable +</code></pre> +<h2 id="building">Building</h2> +<p>Clone the repository and run the <code>just arch</code> recipe:</p> +<pre><code data-lang="sh">git clone https://git.sr.ht/~ijanc/tesseras +cd tesseras +just arch +</code></pre> +<p>This runs <code>makepkg -sf</code> inside <code>packaging/archlinux/</code>, which:</p> +<ol> +<li><strong>prepare</strong> — fetches Cargo dependencies with <code>cargo fetch --locked</code></li> +<li><strong>build</strong> — compiles <code>tesd</code> and <code>tes</code> (the CLI) in release mode</li> +<li><strong>package</strong> — installs binaries, systemd service, sysusers/tmpfiles configs, +shell completions (bash, zsh, fish), and a default config file</li> +</ol> +<p>The result is a <code>.pkg.tar.zst</code> file in <code>packaging/archlinux/</code>.</p> +<h2 id="installing">Installing</h2> +<pre><code data-lang="sh">sudo pacman -U packaging/archlinux/tesseras-*.pkg.tar.zst +</code></pre> +<h2 id="post-install-setup">Post-install setup</h2> +<p>The package creates a <code>tesseras</code> system user and group automatically via +systemd-sysusers. To use the CLI without sudo, add yourself to the group:</p> +<pre><code data-lang="sh">sudo usermod -aG tesseras $USER +</code></pre> +<p>Log out and back in, then start the daemon:</p> +<pre><code data-lang="sh">sudo systemctl enable --now tesd +</code></pre> +<h2 id="what-the-package-includes">What the package includes</h2> +<table><thead><tr><th>Path</th><th>Description</th></tr></thead><tbody> +<tr><td><code>/usr/bin/tesd</code></td><td>Full node daemon</td></tr> +<tr><td><code>/usr/bin/tes</code></td><td>CLI client</td></tr> +<tr><td><code>/etc/tesseras/config.toml</code></td><td>Default configuration (marked as backup)</td></tr> +<tr><td><code>/usr/lib/systemd/system/tesd.service</code></td><td>Systemd unit with security hardening</td></tr> +<tr><td><code>/usr/lib/sysusers.d/tesseras.conf</code></td><td>System user definition</td></tr> +<tr><td><code>/usr/lib/tmpfiles.d/tesseras.conf</code></td><td>Data directory <code>/var/lib/tesseras</code></td></tr> +<tr><td>Shell completions</td><td>bash, zsh, and fish</td></tr> +</tbody></table> +<h2 id="pkgbuild-details">PKGBUILD details</h2> +<p>The PKGBUILD builds directly from the local git checkout rather than downloading +a source tarball. The <code>TESSERAS_ROOT</code> environment variable points makepkg to the +workspace root. Cargo's target directory is set to <code>$srcdir/target</code> to keep +build artifacts inside the makepkg sandbox.</p> +<p>The package depends only on <code>sqlite</code> at runtime and <code>cargo</code> at build time.</p> +<h2 id="updating">Updating</h2> +<p>After pulling new changes, simply run <code>just arch</code> again and reinstall:</p> +<pre><code data-lang="sh">git pull +just arch +sudo pacman -U packaging/archlinux/tesseras-*.pkg.tar.zst +</code></pre> + +</article> + + </main> + + <footer> + <p>© 2026 Tesseras Project. <a href="/atom.xml">News Feed</a> · <a href="https://git.sr.ht/~ijanc/tesseras">Source</a></p> + </footer> +</body> +</html> |