Installation

Choose the installer that matches how you normally manage desktop apps. Package managers are easier to update; the release archive is useful when you want a portable copy. Wox uses the stable update channel by default.

Package Managers

After installation, start Wox from your app launcher or run the installed executable once. Wox creates its data directory on first launch.

Manual Download

Download the latest stable package from GitHub Releases if your platform does not have a package-manager entry yet or you prefer a portable setup.

Update Channels

Wox checks the stable update channel by default. To receive beta prereleases, open Settings -> General -> Update channel and choose Beta channel. Beta users receive beta prereleases and later stable releases; stable users do not receive prereleases automatically.

Windows

1. Download the Windows archive from Releases.
2. Extract it to a directory you control, such as C:\Tools\Wox.
3. Run Wox.exe.

If Windows SmartScreen asks for confirmation, check that the file came from the official Wox release page before continuing.

macOS

1. Download the macOS disk image from Releases.
2. Open the image and drag Wox into Applications.
3. Start Wox from Applications.

If macOS blocks the first launch, open Wox from Finder once and choose Open from the confirmation dialog.

Linux

1. Prefer a package when available:
   • Debian / Ubuntu: install the .deb from Releases with sudo apt install ./wox-linux-amd64.deb
   • Fedora / RHEL: install the .rpm from Releases with sudo dnf install ./wox-linux-amd64.rpm
   • openSUSE: install the .rpm from Releases with sudo zypper install ./wox-linux-amd64.rpm
   • Arch Linux: install wox-bin from the AUR
   • AppImage: download wox-linux-amd64.AppImage, mark it executable, and run it
2. Or download the Linux binary from Releases, extract it to a stable location such as ~/Applications/wox, and run ./wox.

If the binary or AppImage is not executable after download, run:

chmod +x ./wox
# or
chmod +x ./wox-linux-amd64.AppImage

User Data

Wox keeps settings, plugin data, cache, and logs outside the application directory:

Back up this directory if you want to move your configuration to another machine.

Uninstall

Remove the application first, then decide whether to keep user data.

Windows

• Winget: winget uninstall -e --id Wox.Wox
• Scoop: scoop uninstall wox
• Manual install: delete the extracted Wox directory
• Full reset: delete %USERPROFILE%\.wox

macOS

• Homebrew: brew uninstall --cask wox
• Manual install: remove Wox from Applications
• Full reset: remove ~/.wox

Linux

• AUR: remove wox-bin with your AUR helper or package manager
• Debian / Ubuntu: sudo apt remove wox
• Fedora / RHEL: sudo dnf remove wox
• openSUSE: sudo zypper remove wox
• Manual or AppImage install: delete the extracted binary or AppImage file
• Full reset: remove ~/.wox