Tutorials - Category - Nite

Fixing Podman build newuidmap errors on WSL2 Arch Linux

nite@nite07.com (Nite) — Sat, 11 Jul 2026 20:23:42 +1000

A note on fixing newuidmap: Could not set caps when building images with rootless Podman on WSL2 Arch Linux.

Fixing Windows Interop in Arch Linux WSL2

nite@nite07.com (Nite) — Thu, 09 Jul 2026 16:33:30 +0800

Windows executables like powershell.exe fail to run inside Arch Linux WSL2 — fix it with a single config file.

Configuring Fail2Ban for a Podman Mail Server with UFW Bans

nite@nite07.com (Nite) — Thu, 09 Jul 2026 15:30:00 +0800

Configure Fail2Ban on an Arch Linux host with a rootless Podman mail server, then use UFW to manage bans for SSH, Postfix, and SASL brute-force sources.

Hide the Console Window When Auto-Starting WSL2

nite@nite07.com (Nite) — Thu, 09 Jul 2026 02:00:00 +0800

Use a VBS script to launch WSL2 with a hidden window, so auto-start at login doesn’t pop up a console window.

mihomo TUN Mode Breaks Networking: ip_forward and UFW forward Policy

nite@nite07.com (Nite) — Tue, 30 Jun 2026 03:15:00 +1000

Enabling mihomo TUN mode causes a total network outage because system ip_forward is disabled and UFW’s forward policy is set to DROP, so the kernel refuses to forward TUN traffic.

After installing MinerU with uv tool install, you still need cuda and ninja

nite@nite07.com (Nite) — Sun, 28 Jun 2026 01:25:45 +1000

A quick note on a MinerU install gotcha: uv tool install "mineru[all]" only handles the Python side. To run hybrid-engine on Arch, you still need the system packages cuda and ninja.

Changing Honcho Embedding Dimensions: From 1536 to 1024

nite@nite07.com (Nite) — Fri, 26 Jun 2026 02:30:00 +1000

Honcho’s first startup Alembic migration pins the pgvector embedding column to vector(1536), which conflicts with EMBEDDING_VECTOR_DIMENSIONS=1024 in .env and causes startup to fail. This post documents fixing it with the official configure_embeddings.py script.

Virtual Display on KDE Wayland: krfb-virtualmonitor + Sunshine Streaming

nite@nite07.com (Nite) — Tue, 26 May 2026 17:07:22 +1000

Create a virtual display on KDE Wayland using krfb-virtualmonitor, paired with Sunshine’s kwin capture and Moonlight’s built-in display switching. No kernel parameters required.

Running Gitea Runner with Rootless Podman

nite@nite07.com (Nite) — Tue, 19 May 2026 12:00:00 +1000

This article is part of the “quadlet config snippets” series. For the Quadlet basics, see Podman Tutorial. For the full Gitea setup, see Quadlet Config Share: Gitea.

I ran into this while using rootless Podman to run a Gitea Actions Runner. Leaving the note here.

Job container fails with `making volume mountpoint`

The Runner starts normally, but the workflow fails with this error:

Adding Playwright MCP + CloakBrowser to an Agent

nite@nite07.com (Nite) — Tue, 19 May 2026 11:00:00 +1000

A walkthrough of configuring an Agent with Playwright MCP and switching it to CloakBrowser for anti-detection browsing, including the gotchas and a cookie persistence setup.

Syntax Differences Between .qmd and .md

nite@nite07.com (Nite) — Sat, 09 May 2026 10:00:00 +1000

An overview of the extra syntax and use cases Quarto .qmd files add on top of regular .md files.

Fixing Podman login credentials disappearing after reboot

nite@nite07.com (Nite) — Tue, 05 May 2026 13:00:00 +1000

Rootless Podman writes auth.json to a temporary runtime directory by default. This article records how to persist the authfile and set REGISTRY_AUTH_FILE.

Self-Hosted Mail Server Troubleshooting

nite@nite07.com (Nite) — Fri, 01 May 2026 13:00:00 +1000

This article summarizes a general troubleshooting workflow for self-hosted mail servers, covering common issues around DNS, ports, TLS, service binding, client autodiscovery, and local network interference.

PostgreSQL 18 Docker Upgrade: Migrating from 17

nite@nite07.com (Nite) — Fri, 01 May 2026 02:43:51 +0000

PostgreSQL 18 changed the default data directory used by the official Docker image. This article walks through a practical migration from PostgreSQL 17 to 18 with backup, container recreation, data restore, and cleanup.

Quadlet Config Share: Gitea

nite@nite07.com (Nite) — Wed, 29 Apr 2026 05:00:00 +1000

Share a Quadlet configuration for Gitea, with PostgreSQL and an optional Runner.

Quadlet Config Share: AxonHub

nite@nite07.com (Nite) — Wed, 29 Apr 2026 04:00:00 +1000

Share a Quadlet configuration for AxonHub.

Hugo multilingual collection translation: solving the language switcher issue with different display names

nite@nite07.com (Nite) — Wed, 29 Apr 2026 02:30:00 +1000

When Chinese and English posts use different collection names, the language switcher on collection pages and article pages may disappear. The solution is simpler than expected.

Quadlet Config Share: Vaultwarden

nite@nite07.com (Nite) — Wed, 29 Apr 2026 01:10:00 +1000

Share a Quadlet configuration for Vaultwarden.

Caddy + Hugo: Language-Aware Redirection Based on Accept-Language

nite@nite07.com (Nite) — Tue, 28 Apr 2026 21:00:00 +0800

A detailed guide on implementing automatic language redirection for Hugo static sites using Caddy, based on the browser’s Accept-Language header, including path redirects, file-existence fallbacks, language priority demotion, and a complete multilingual site configuration.

Caddy WebDAV Configuration: Subpath Mounting and Access Control

nite@nite07.com (Nite) — Tue, 28 Apr 2026 20:45:00 +0800

How to set up WebDAV file management in Caddy, including subpath mounting, basic_auth access control, route priority adjustment with the order directive, and configuration examples for different WebDAV use cases.

Caddy MaxMind GeoIP Access Control: Whitelist and Blacklist Modes

nite@nite07.com (Nite) — Tue, 28 Apr 2026 20:15:00 +0800

How to implement IP geolocation-based whitelist/blacklist access control using Caddy’s maxmind-geolocation plugin, including GeoLite2 database auto-update setup and configuration examples for both modes.

Caddy rate_limit Configuration

nite@nite07.com (Nite) — Tue, 28 Apr 2026 20:00:00 +0800

How to configure Caddy’s rate_limit plugin, including zone definition, key selection, and window tuning — plus why I ultimately chose to comment out this rule in my actual deployment.

Caddy Cloudflare DNS-01: Get Wildcard TLS Certificates

nite@nite07.com (Nite) — Tue, 28 Apr 2026 19:45:00 +0800

How to use Caddy with Cloudflare DNS-01 to automatically get wildcard TLS certificates, with the API Token permissions and global Caddyfile settings you need, plus real client IP handling behind Cloudflare.

Building Custom Caddy with xcaddy: Plugin Selection to CI/CD Auto-Publish

nite@nite07.com (Nite) — Tue, 28 Apr 2026 19:30:00 +0800

A from-scratch guide on using xcaddy to build a custom Caddy image with plugins, including each plugin’s purpose, multi-stage Dockerfile design, and a complete CI/CD workflow via GitHub Actions that auto-builds and pushes to Docker Hub weekly.

MinerU on Low VRAM: When hybrid OOMs but vlm Works Fine

nite@nite07.com (Nite) — Thu, 23 Apr 2026 16:30:00 +0800

Documenting the hybrid-auto-engine OOM issue encountered when deploying MinerU on an 8GB GPU, and why vlm-auto-engine turns out to use less VRAM — backed by source code analysis and the final solution.

Using the Microsoft VS Code Marketplace in code-server

nite@nite07.com (Nite) — Mon, 13 Apr 2026 05:57:46 +1000

This article records how to configure EXTENSIONS_GALLERY for code-server under a systemd user service and avoid the common pitfalls around % and quoting.

Resolving Netbird and Mihomo (Tun Mode) Coexistence Issues on Linux

nite@nite07.com (Nite) — Sat, 17 Jan 2026 16:50:52 +0800

This article explains how to resolve the issue where Netbird and Mihomo (Tun Mode) fail to establish P2P connections by adding specific routing table rules.

Deploying a Github Mirror Using Caddy

nite@nite07.com (Nite) — Fri, 05 Dec 2025 00:50:00 +0800

This article explains how to mirror GitHub websites using Caddy2 for accessing GitHub in network-restricted regions.

Stalwart SMTP Outgoing Mail Auto-Archiving

nite@nite07.com (Nite) — Mon, 24 Nov 2025 17:56:00 +1100

If you are using the modern Stalwart Mail Server, you may have noticed a classic email architecture pain point:

When you send emails using clients like Thunderbird or Outlook, the sent emails dutifully reside in the “Sent” folder; however, when you configure notification bots (e.g., notification@example.com) or ERP systems to send emails automatically via the SMTP protocol, the outbox is empty.

Why is this happening? This is because the standard SMTP protocol is only responsible for “transmission,” not “storage.” Desktop clients are able to save backups because they perform an additional IMAP upload operation after sending. Simple SMTP scripts usually do not perform this step.

Git includeIf for Multiple Git Identities

nite@nite07.com (Nite) — Fri, 14 Nov 2025 15:50:00 +1100

When you maintain both work and personal projects, it is easy to use the wrong Git identity: committing to a company project with a personal email, or exposing a work email in an open-source project. Manually switching Git config is tedious and error-prone.

Git includeIf can automatically load different config files based on conditions, which makes it a good fit for managing multiple identities.

Why Do We Need includeIf?

In daily development, we often need to switch between different identities:

Game Resource Site Tutorial

nite@nite07.com (Nite) — Sat, 08 Nov 2025 00:10:00 +1100

You should be able to find the answers to most of your problems here. Choose the section you need to read.

1. Game Resource Download Tutorial

Magnet links and .torrent files are both download entry points for BT clients. A magnet link can be pasted directly, while a .torrent file is a small file that you import into the client.

GPT-SoVITS: Few-Shot Voice Cloning and TTS

nite@nite07.com (Nite) — Thu, 06 Nov 2025 14:38:00 +1100

GPT-SoVITS is an advanced few-shot voice cloning and text-to-speech (TTS) tool that achieves high-quality voice cloning with just 1 minute of reference audio. Developed by the RVC-Boss team, this project combines GPT semantic modeling and diffusion acoustic modeling techniques, gaining widespread attention in the open-source community. Its core strengths lie in extremely low training data requirements, cross-lingual voice generation capabilities, and a user-friendly WebUI interface, making professional-grade speech synthesis technology accessible.

Load Local Subtitles While MPV Plays Remote Videos

nite@nite07.com (Nite) — Thu, 04 Sep 2025 20:00:52 +1000

This article explains how to tweak MPV launch parameters so that local subtitle files are loaded when playing remote videos.

Podman Rootless Tips: Using --group-add keep-groups to Solve Volume Group Permission Issues

nite@nite07.com (Nite) — Thu, 04 Sep 2025 14:30:52 +1000

This article introduces how to elegantly solve the problem of containers being unable to access directories managed by group permissions on the host in Podman Rootless mode by using the --group-add keep-groups parameter when starting containers.

KDE Context Menu Files

nite@nite07.com (Nite) — Thu, 04 Sep 2025 03:13:00 +1000

This article provides some Dolphin context menu files for reference.

Building Your Own Private Git Server with Gitolite

nite@nite07.com (Nite) — Mon, 01 Sep 2025 19:45:00 +1000

This article introduces how to create a Git server using Gitolite.

Jetbrains Series Software Activation Tutorial

nite@nite07.com (Nite) — Sat, 09 Aug 2025 10:00:00 +1000

This article introduces how to activate Jetbrains series software.

Enabling Nvidia GPU Acceleration in WSL2 (Archlinux) and Podman

nite@nite07.com (Nite) — Wed, 23 Jul 2025 12:00:00 +0800

This article explains how to configure Podman to use Nvidia GPU acceleration in WSL2 Arch Linux environment.

Podman Container Startup Delays: network-online.target Dependency Issue

nite@nite07.com (Nite) — Mon, 21 Jul 2025 00:40:52 +0800

Containers managed by Podman and Quadlet may hang during startup with a 90-second timeout. The issue is usually related to systemd’s network-online.target not being activated. This article presents three solutions.

Podman Mounted Directory Permission Denied: A SELinux Gotcha

nite@nite07.com (Nite) — Sun, 20 Jul 2025 18:40:52 +0800

When mounting host directories to Podman containers, you may encounter Permission denied even as root. This article analyzes how SELinux security mechanisms affect container access and provides a fix.

Using Caddy Containers and Cgit to Display Git Repositories

nite@nite07.com (Nite) — Sun, 20 Jul 2025 15:45:00 +0800

This tutorial builds upon “Setting up Your Private Git Server with Caddy and Containers”. It integrates cgit into an existing Git server to provide a feature-rich web interface for browsing repositories.

Setting Up Midnight Commander Double-Click to Open Files

nite@nite07.com (Nite) — Sat, 19 Jul 2025 14:30:52 +0800

This article explains how to configure Midnight Commander (mc) to open files with a custom editor (like $EDITOR) when double-clicking or pressing Enter, improving file management efficiency.

Podman Quadlet Basics: Let Systemd Manage Your Containers

nite@nite07.com (Nite) — Sat, 19 Jul 2025 10:10:52 +0800

This article introduces the basics of Podman Quadlet: what Quadlet is, its file types and structure, how to write simple .container and .pod files, and how to manage container lifecycles through Systemd.

Git GPG Key Generation and Migration

nite@nite07.com (Nite) — Sat, 19 Jul 2025 00:31:00 +0800

This article provides a detailed guide on how to generate and migrate GPG keys, helping you achieve Git commit signing across multiple devices and easily obtain the GitHub “Verified” badge.

Building a Git over HTTPS Server with Caddy and Containers

nite@nite07.com (Nite) — Fri, 18 Jul 2025 11:45:00 +0800

This article explains how to quickly set up a lightweight private Git server with HTTPS support and basic authentication using Caddy2 and containers. It’s perfect for scenarios that don’t require full GitLab/Gitea functionality, offering simple configuration, security, and efficiency for personal or small team self-hosted code hosting platforms.

Syncthing Relay Node: A Regular Client Is Enough

nite@nite07.com (Nite) — Thu, 17 Jul 2025 03:20:52 +0800

A simpler Syncthing multi-device setup: skip self-hosted discovery and relay servers, and run a standard Syncthing client on an always-online device.

Remote Synchronized Movie Watching with Alist/Openlist/Rclone + Syncplay

nite@nite07.com (Nite) — Thu, 17 Jul 2025 02:44:52 +0800

Use Alist/Openlist/Rclone to generate direct cloud storage links, then use Syncplay for remote synchronized movie watching.

Enabling SOCKS5 Proxy on Windows Tailscale

nite@nite07.com (Nite) — Wed, 16 Jul 2025 12:19:00 +0800

This article introduces how to enable Userspace Networking mode and built-in SOCKS5 proxy on Windows systems by modifying Tailscale service startup parameters, allowing specific applications to use Tailscale network proxy on demand while avoiding global traffic hijacking and improving usage flexibility

Turn Idle Devices into Windows Extended Screens Using Sunshine, Moonlight, and Virtual-Display-Driver

nite@nite07.com (Nite) — Thu, 05 Jun 2025 05:10:00 +1000

Create virtual displays using Virtual-Display-Driver, combined with Sunshine streaming server and Moonlight client, to turn Android phones, tablets, and other idle devices into wireless extended screens for Windows computers. This tutorial provides detailed configuration steps for all three tools to achieve an efficient screen extension solution within the same local network.

Using Xbox Controller on Archlinux

nite@nite07.com (Nite) — Sun, 15 Dec 2024 00:22:52 +0800

Xbox Controller Connection Guide on Arch Linux

On Arch Linux, there are three main ways to connect an Xbox controller. Please choose the driver solution corresponding to your connection method:

Steam Game Cracker

nite@nite07.com (Nite) — Fri, 13 Dec 2024 00:45:52 +0800

Game Cracking

GBE FORK

https://github.com/Detanup01/gbe_fork

Linux Sing-box and Tailscale Coexistence Issue

nite@nite07.com (Nite) — Mon, 09 Dec 2024 20:00:00 +0800

Problem Description

When using Sing-box, the Tailscale client cannot work properly. Other devices can ping the host through tailscale ping <ip/hostname>, but cannot establish connections (e.g., SSH shows Connection refused).

Running Pirated Games (exe), Online-fix, and Game File Acquisition on Archlinux

nite@nite07.com (Nite) — Wed, 27 Nov 2024 23:22:52 +0800

Using Archlinux as an example, please adjust commands accordingly for other distributions.

0. (Optional) Install proton-ge-custom

GE-Custom has the following advantages over the official version:

Archlinux Clevo Laptop Driver and Control Center Installation

nite@nite07.com (Nite) — Sun, 03 Nov 2024 11:45:52 +0800

The fan scheduling on Clevo computers is really annoyingly loud. I used to use Windows and relied on Ryzen Master for undervolting to control CPU temperature, which indirectly reduced fan speed. Now that I’ve switched to Linux, it’s unbearable without proper configuration. I spent ages searching on Google and found a bunch of GitHub repositories. After trying several that didn’t work well, I finally discovered that someone in the AUR repository had already packaged useful solutions (I absolutely love pacman and AUR!). https://aur.archlinux.org/packages?K=clevo

Using GO sync.Once

nite@nite07.com (Nite) — Fri, 25 Oct 2024 03:10:52 +0800

sync.Once is used to ensure that a function executes only once, regardless of how many goroutines attempt to execute it. It has one method Do(f func()) that takes the function to be executed.

Basic usage example:

package main

import (
    "fmt"
    "sync"
)

func main() {
    var once sync.Once
    done := make(chan bool)

    // Simulate multiple goroutines calling
    for i := 0; i < 10; i++ {
        go func(x int) {
            // The function passed to once.Do() will only execute once
            once.Do(func() {
                fmt.Printf("Execute only once: %d\n", x)
            })
            // This line will be executed by every goroutine
            fmt.Printf("goroutine %d completed\n", x)
            done <- true
        }(i)
    }

    // Wait for all goroutines to complete
    for i := 0; i < 10; i++ {
        <-done
    }
}

Common use cases:

Archlinux RDP Connection Issues

nite@nite07.com (Nite) — Sun, 20 Oct 2024 16:45:52 +0800

If you are using the RDP protocol from a non-Windows device to remotely control a Windows machine logged in with a Microsoft account, the username you enter when connecting might not be your Microsoft account (email), nor the remaining part after removing the email suffix, and certainly not Administrator. Instead, it could be some other value. You can check this by running echo %USERNAME% on the controlled machine. Although this value is set by yourself, it’s completely nowhere to be found in the system settings. I was really frustrated trying to figure this out for quite a while.

Archlinux Wayland Input Method Issues

nite@nite07.com (Nite) — Sat, 19 Oct 2024 01:22:52 +0800

fcitx5 Input Method Not Available

Set the virtual keyboard to fcitx 5 in the desktop environment settings

KDE Plasma Issues Caused by Nvidia Drivers in Archlinux