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)

A source-built package, mindwtr, also exists on the AUR. It is maintained by the community, not by the Mindwtr project, and it is not part of the Mindwtr release pipeline. Use mindwtr-bin unless you need to build locally.

Verify the official AUR packages

Mindwtr publishes two current AUR identities: mindwtr-bin (stable prebuilt) and mindwtr-beta-bin (prerelease). A third name, mindwtr-bin-beta, is the previous beta identity; it is still updated from the same signed release artifacts while the rename is in progress. Their package source must point to github.com/dongdongbh/Mindwtr, and the maintainer must be 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
repo_gpgcheck=1
gpgkey=https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key
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)

AppImage catalog listing

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.

Microsoft Store Beta

You can test release candidates through the same Store installation. Email the Microsoft account address you use in the Store to support@mindwtr.app, or share it in the beta discussion, and I will add you to Mindwtr Beta. After enrollment and flight publication, check Microsoft Store → Library for updates. Keep your existing installation so your tasks and attachments stay in place. See Join the Beta Channels for enrollment and leaving instructions.

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 extras
scoop install extras/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)

Moving between portable and installed on Windows. Since v1.3.2 the installed app uses the same config\ and data\ layout under %APPDATA%\mindwtr, so the two portable subfolders copy straight across; the WebView2 profile lives in %LOCALAPPDATA%\tech.dongdongbh.mindwtr. Close Mindwtr on both sides before copying.

Portable	Installed
profile\data\ (mindwtr.db, data.json, attachments\, logs, snapshots)	%APPDATA%\mindwtr\data\
profile\config\config.toml	%APPDATA%\mindwtr\config\config.toml
profile\config\secrets.toml	not a file: the installed app stores secrets in Windows Credential Manager, so re-enter the sync passphrase, Dropbox login, or API keys after moving
profile\webview\	%LOCALAPPDATA%\tech.dongdongbh.mindwtr\ (cache only; safe to skip)

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

---

Verifying Downloads

Every GitHub release includes a SHA256SUMS checksum manifest and a detached PGP signature SHA256SUMS.asc covering it. They are signed with the same key that signs the APT and RPM repositories, published at https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key:

• Key: Mindwtr Bot (RSA 4096)
• Fingerprint: 0358 999B BE70 4F58 8B90 9497 9E55 3245 CB17 047D

The same key is also published on the keys.openpgp.org keyserver, independent of GitHub's infrastructure — fetch it from both sources and confirm they show the identical fingerprint above.

# Import the signing key
curl -fsSL https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key | gpg --import

# Or fetch it from the keys.openpgp.org keyserver (independent second source)
gpg --keyserver hkps://keys.openpgp.org --recv-keys 0358999BBE704F588B9094979E553245CB17047D

# Verify the manifest signature
gpg --verify SHA256SUMS.asc SHA256SUMS

# Check the file you downloaded against the manifest
sha256sum --check --ignore-missing SHA256SUMS

gpg --verify must report a good signature from the fingerprint above. On macOS, use shasum -a 256 --check --ignore-missing SHA256SUMS for the checksum step.

---

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/data/mindwtr.db	%APPDATA%/mindwtr/data/data.json
macOS	~/Library/Application Support/mindwtr/data/mindwtr.db	~/Library/Application Support/mindwtr/data/data.json

Flatpak installs use sandboxed XDG paths under ~/.var/app/tech.dongdongbh.mindwtr/. The database is at ~/.var/app/tech.dongdongbh.mindwtr/data/mindwtr/mindwtr.db.

Config is stored separately:

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

Before v1.3.2, Windows and macOS kept all of these files directly in the mindwtr folder. The first start of v1.3.2 moves them into config/ and data/ and leaves everything else in the folder alone. Going back to an older version after that is not supported: it only looks in the old place.

---

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