Hugo Blog about my favorite topics 2026-09-04T02:22:57+08:00 http://localhost:1313/ http://localhost:1313/posts/start-here/ 2026-08-20T09:00:00+08:00 2026-09-04T01:20:40+08:00 <p>Welcome! This post is <strong>pinned</strong> so it stays at the top of the list no matter how many newer posts come after it.</p> <div class="flex align-center gblog-post__anchorwrap"> <h2 id="what-you-will-find-here" > What you will find here </h2> <a data-clipboard-text="http://localhost:1313/posts/start-here/#what-you-will-find-here" class="gblog-post__anchor clip flex align-center" aria-label="Anchor What you will find here" href="#what-you-will-find-here"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <ul> <li>Notes about Linux, tooling, and open source</li> <li>Small solutions to problems I ran into myself</li> <li>Occasional book and paper reading notes</li> </ul> <blockquote> <p>The best time to start a blog was ten years ago. The second best time is today.</p> </blockquote> <p>If you are new here, this is the place to begin.</p> http://localhost:1313/posts/first-post/ 2026-09-04T00:27:32+08:00 2026-09-04T01:09:31+08:00 <p>fasdfadsf</p> http://localhost:1313/notes/self-hosting-ideas/ 2026-09-03T22:10:00+08:00 2026-09-04T01:20:40+08:00 <p>A running list of services that earn their RAM on a small home server.</p> <div class="flex align-center gblog-post__anchorwrap"> <h2 id="proven" > Proven </h2> <a data-clipboard-text="http://localhost:1313/notes/self-hosting-ideas/#proven" class="gblog-post__anchor clip flex align-center" aria-label="Anchor Proven" href="#proven"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <ul> <li><strong>Uptime Kuma</strong> — lightweight status monitoring with a nice UI</li> <li><strong>Syncthing</strong> — folder sync without a cloud middleman</li> <li><strong>Pi-hole</strong> — network-wide ad blocking</li> </ul> <div class="flex align-center gblog-post__anchorwrap"> <h2 id="on-the-shortlist" > On the shortlist </h2> <a data-clipboard-text="http://localhost:1313/notes/self-hosting-ideas/#on-the-shortlist" class="gblog-post__anchor clip flex align-center" aria-label="Anchor On the shortlist" href="#on-the-shortlist"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <ul> <li><strong>Immich</strong> — self-hosted photos, the current favorite to replace cloud albums</li> <li><strong>Paperless-ngx</strong> — scan once, find forever</li> </ul> <div class="flex align-center gblog-post__anchorwrap"> <h2 id="retired" > Retired </h2> <a data-clipboard-text="http://localhost:1313/notes/self-hosting-ideas/#retired" class="gblog-post__anchor clip flex align-center" aria-label="Anchor Retired" href="#retired"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <ul> <li>A full Nextcloud instance. It worked, but I only ever used two features.</li> </ul> http://localhost:1313/posts/restic-backups/ 2026-09-03T19:45:00+08:00 2026-09-04T01:20:40+08:00 <p>After years of ad-hoc <code>rsync</code> scripts, I finally settled on <code>restic</code> for local snapshots. Initialize a repository once:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">restic init --repo /mnt/backup/restic </span></span></code></pre></div><p>Then back up your home directory, excluding the usual noise:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">restic -r /mnt/backup/restic backup ~ <span class="se">\ </span></span></span><span class="line"><span class="cl"> --exclude ~/.cache <span class="se">\ </span></span></span><span class="line"><span class="cl"> --exclude ~/Downloads </span></span></code></pre></div><p>Check what snapshots exist and prune old ones:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">restic -r /mnt/backup/restic snapshots </span></span><span class="line"><span class="cl">restic -r /mnt/backup/restic forget --keep-daily <span class="m">7</span> --keep-weekly <span class="m">4</span> </span></span></code></pre></div><p>The part that convinced me: restores are first-class, not an afterthought.</p> http://localhost:1313/posts/reading-list-2026/ 2026-09-02T21:15:00+08:00 2026-09-04T01:20:40+08:00 <p>Things I finished or abandoned this month.</p> <div class="flex align-center gblog-post__anchorwrap"> <h2 id="finished" > Finished </h2> <a data-clipboard-text="http://localhost:1313/posts/reading-list-2026/#finished" class="gblog-post__anchor clip flex align-center" aria-label="Anchor Finished" href="#finished"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <ul> <li><em>The Pragmatic Programmer</em> (20th anniversary edition) — still holds up</li> <li><em>A Philosophy of Software Design</em> — the best short explanation of deep vs. shallow modules I know</li> </ul> <div class="flex align-center gblog-post__anchorwrap"> <h2 id="in-progress" > In progress </h2> <a data-clipboard-text="http://localhost:1313/posts/reading-list-2026/#in-progress" class="gblog-post__anchor clip flex align-center" aria-label="Anchor In progress" href="#in-progress"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <ul> <li><em>Thinking in Systems</em> — slower going, but worth it</li> </ul> <div class="flex align-center gblog-post__anchorwrap"> <h2 id="abandoned-without-guilt" > Abandoned without guilt </h2> <a data-clipboard-text="http://localhost:1313/posts/reading-list-2026/#abandoned-without-guilt" class="gblog-post__anchor clip flex align-center" aria-label="Anchor Abandoned without guilt" href="#abandoned-without-guilt"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <ul> <li>A 600-page Kubernetes certification guide. Life is too short for bad diagrams.</li> </ul> <blockquote> <p>Reading lists are mostly a promise to your future self.</p> </blockquote> http://localhost:1313/notes/hugo-cheatsheet/ 2026-09-02T08:00:00+08:00 2026-09-04T01:20:40+08:00 <p>Quick reference for the commands and file layout I keep forgetting.</p> <div class="flex align-center gblog-post__anchorwrap"> <h2 id="commands" > Commands </h2> <a data-clipboard-text="http://localhost:1313/notes/hugo-cheatsheet/#commands" class="gblog-post__anchor clip flex align-center" aria-label="Anchor Commands" href="#commands"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo server -D <span class="c1"># dev server, include drafts</span> </span></span><span class="line"><span class="cl">hugo --gc <span class="c1"># production build into public/</span> </span></span></code></pre></div><div class="flex align-center gblog-post__anchorwrap"> <h2 id="where-things-live" > Where things live </h2> <a data-clipboard-text="http://localhost:1313/notes/hugo-cheatsheet/#where-things-live" class="gblog-post__anchor clip flex align-center" aria-label="Anchor Where things live" href="#where-things-live"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <table> <thead> <tr> <th>Path</th> <th>Purpose</th> </tr> </thead> <tbody> <tr> <td><code>content/posts/</code></td> <td>blog posts</td> </tr> <tr> <td><code>content/notes/</code></td> <td>reference notes</td> </tr> <tr> <td><code>data/menu/extra.yaml</code></td> <td>header/footer menu entries</td> </tr> <tr> <td><code>themes/hugo-geekblog/</code></td> <td>theme (git submodule)</td> </tr> </tbody> </table> <div class="flex align-center gblog-post__anchorwrap"> <h2 id="remember" > Remember </h2> <a data-clipboard-text="http://localhost:1313/notes/hugo-cheatsheet/#remember" class="gblog-post__anchor clip flex align-center" aria-label="Anchor Remember" href="#remember"> <svg class="gblog-icon gblog_link"><use xlink:href="#gblog_link"></use></svg> </a> </div> <p>The theme must be built once after a fresh clone:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">cd</span> themes/hugo-geekblog <span class="o">&amp;&amp;</span> npm install <span class="o">&amp;&amp;</span> npm run build </span></span></code></pre></div> http://localhost:1313/posts/terminal-tips/ 2026-09-01T10:30:00+08:00 2026-09-04T01:20:40+08:00 <p>Small habits that compound over time:</p> <ol> <li><strong>Jump back to the previous directory</strong></li> </ol> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">cd</span> /var/log </span></span><span class="line"><span class="cl"><span class="nb">cd</span> ~/projects </span></span><span class="line"><span class="cl"><span class="nb">cd</span> - <span class="c1"># back to /var/log</span> </span></span></code></pre></div><ol start="2"> <li><strong>Reuse arguments from the previous command</strong></li> </ol> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">mkdir -p ~/.local/bin </span></span><span class="line"><span class="cl"><span class="nb">cd</span> !!:1 </span></span></code></pre></div><ol start="3"> <li> <p><strong>Search shell history incrementally</strong> with <code>Ctrl+R</code>.</p> </li> <li> <p><strong>Fix a long command</strong> with <code>fc</code> — it opens the last command in your editor.</p> </li> <li> <p><strong>Watch a file instead of re-running a command</strong></p> </li> </ol> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">watch -n <span class="m">2</span> <span class="s1">&#39;df -h /&#39;</span> </span></span></code></pre></div><p>None of these are fancy, but together they save real time every day.</p>