Desktop Installation

Detailed installation instructions for all desktop platforms.

For release-candidate and beta builds, see Join the Beta Channels.

---

Linux

Arch Linux (AUR, Prebuilt)

The easiest way to install on Arch-based distributions is the prebuilt AUR package:

# Using yay
yay -S mindwtr-bin

# Using paru
paru -S mindwtr-bin

# Using pamac (Manjaro)
pamac install mindwtr-bin

AUR package: mindwtr-bin

Arch Linux (AUR, Build from Source)

Use the source-built AUR package if you prefer to build locally:

# Using yay
yay -S mindwtr

# Using paru
paru -S mindwtr

AUR package: mindwtr

Verify the official AUR packages

Mindwtr recognizes exactly three AUR identities: mindwtr-bin (stable prebuilt), mindwtr (stable source build), and mindwtr-bin-beta (prerelease). Their package source must point to github.com/dongdongbh/Mindwtr; the maintainer or co-maintainer must include dongdongbh. Review every PKGBUILD and .SRCINFO change before building. New release checksum manifests are signed by key fingerprint 0358 999B BE70 4F58 8B90 9497 9E55 3245 CB17 047D.

Debian / Ubuntu

Add the APT repo (recommended):

curl -fsSL https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/mindwtr-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/mindwtr-archive-keyring.gpg] https://dongdongbh.github.io/Mindwtr/deb ./" | sudo tee /etc/apt/sources.list.d/mindwtr.list
sudo apt update
sudo apt install mindwtr

Manual install: download the .deb from GitHub Releases and run sudo dpkg -i mindwtr_*.deb.

Fedora / RHEL / openSUSE

Add the DNF/YUM repo (recommended):

cat <<'EOF' | sudo tee /etc/yum.repos.d/mindwtr.repo
[mindwtr]
name=Mindwtr Repository
baseurl=https://dongdongbh.github.io/Mindwtr/rpm
enabled=1
gpgcheck=0
EOF

sudo dnf install mindwtr

Manual install: download the .rpm from GitHub Releases and run sudo rpm -i mindwtr-*.rpm.

Flatpak (Flathub)

Install from Flathub:

flatpak install flathub tech.dongdongbh.mindwtr

Run it with:

flatpak run tech.dongdongbh.mindwtr

Flathub listing

Snap Store

Install from the Snap Store:

sudo snap install mindwtr

Snap Store listing

AppImage (Universal)

Works on most Linux distributions:

# Download the versioned AppImage from:
# https://github.com/dongdongbh/Mindwtr/releases/latest

# Make executable
chmod +x Mindwtr-*.AppImage

# Run
./Mindwtr-*.AppImage

Tip: Use AppImageLauncher for better desktop integration.

Other Distributions

For other distributions, use the AppImage or build from source (see Developer Guide).

Community-maintained packages (for example nixpkgs for NixOS) are welcome. The desktop build vendors its TLS dependency, so packaging does not need a system OpenSSL match. If you maintain one, open a discussion so it can be linked here.

---

Windows

Microsoft Store (Recommended)

Install from the Microsoft Store.

Winget

Winget is built into Windows 10 and 11. Install Mindwtr with:

winget install dongdongbh.Mindwtr

Chocolatey

If you use Chocolatey:

choco install mindwtr

Chocolatey package

Scoop

If you use Scoop:

scoop bucket add mindwtr https://github.com/dongdongbh/homebrew-mindwtr
scoop install mindwtr

Installer (.exe)

1. Download the installer from GitHub Releases
2. Run the installer
3. Follow the installation wizard
4. Launch Mindwtr from the Start menu

Portable

1. Download mindwtr_<version>_windows_x64_portable.zip from GitHub Releases.
2. Extract it to any writable folder.
3. Keep portable.txt next to mindwtr.exe.

Portable mode stores local state beside the executable:

• profile/data/ for the SQLite DB, sync JSON, attachments, logs, snapshots, audio captures, and speech models
• profile/config/ for config.toml and secrets.toml
• profile/webview/ for the WebView2 browser profile (cache, local storage)

Windows WebView2 is still required. Attachment files that a portable build older than v1.1.0 stored under AppData\Roaming\mindwtr are moved into the portable profile on first launch; when an installed Mindwtr shares the machine they are copied instead, so both installs keep working.

---

macOS

Mac App Store (Recommended)

Install from the Mac App Store:

Mindwtr on the Mac App Store

Use this option if you want store-managed updates and the signed App Store build.

TestFlight Beta

Join the macOS beta through TestFlight:

Mindwtr TestFlight beta

More beta channels and leave-beta instructions are covered in Join the Beta Channels.

Homebrew

Install using Homebrew:

brew install --cask mindwtr

Disk Image (.dmg)

1. Download the .dmg from GitHub Releases
2. Open the disk image
3. Drag Mindwtr to your Applications folder
4. Launch from Applications or Spotlight

---

Data Location

After installation, your data is stored at:

Platform	SQLite DB	Sync JSON
Linux	~/.local/share/mindwtr/mindwtr.db	~/.local/share/mindwtr/data.json
Windows	%APPDATA%/mindwtr/mindwtr.db	%APPDATA%/mindwtr/data.json
macOS	~/Library/Application Support/mindwtr/mindwtr.db	~/Library/Application Support/mindwtr/data.json

Flatpak installs use sandboxed XDG paths under ~/.var/app/tech.dongdongbh.mindwtr/. You can always check the exact active paths in Settings → Sync → Local Data.

Config is stored separately:

Platform	Location
Linux	~/.config/mindwtr/config.toml
Windows	%APPDATA%/mindwtr/config.toml
macOS	~/Library/Application Support/mindwtr/config.toml

---

Updating

Update checks are channel-aware: Mindwtr detects how it was installed, compares against the version published for that channel, and points you to that channel's update path.

• Microsoft Store, Winget, Chocolatey, Homebrew, AUR: the update reminder only appears once your channel has the new version; update with your package manager as usual (for example winget upgrade dongdongbh.Mindwtr, choco upgrade mindwtr, brew upgrade --cask mindwtr).
• Scoop: Mindwtr makes no automatic update checks at all, since any bucket can carry the manifest and Scoop owns updates (scoop update mindwtr). The manual check in Settings → About still works.
• Flatpak, Snap, and the app stores' auto-update: updates arrive automatically, so Mindwtr stays quiet.
• Direct download, portable, AppImage, .deb/.rpm: check in Settings → About → Check for Updates, then download the new version from Releases and install over your existing installation.

Your data is preserved between updates.

---

Uninstalling

Linux (Package Manager)

# AUR
yay -R mindwtr-bin

# Debian/Ubuntu
sudo dpkg -r mindwtr

# Flatpak
flatpak uninstall tech.dongdongbh.mindwtr

Windows

Use "Add or Remove Programs" in Windows Settings.

macOS

Drag Mindwtr from Applications to Trash.

Data Cleanup

To remove all data, delete both the config and data directories:

# Linux
rm -rf ~/.config/mindwtr
rm -rf ~/.local/share/mindwtr

# macOS
rm -rf ~/Library/Application\ Support/mindwtr

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:APPDATA\\mindwtr"

---

Troubleshooting

App Won't Start (Linux)

Ensure WebKitGTK is installed:

# Arch
sudo pacman -S webkit2gtk-4.1

# Debian/Ubuntu
sudo apt install libwebkit2gtk-4.1-0

Missing Icons

Install a complete icon theme:

sudo pacman -S papirus-icon-theme

Blank Window

Try running with GPU disabled:

WEBKIT_DISABLE_DMABUF_RENDERER=1 mindwtr

---

See Also

• Getting Started
• User Guide Desktop
• Data and Sync