1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
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>
|