Installation & Setup
Mise is designed to be efficient, modular, and easy to run across Linux, macOS, and Windows. You can download pre-built self-contained binaries directly from GitHub Releases or run from source.
Pre-Built Executables
Official releases and cryptographic checksums are published for every tagged version on the GitHub Releases page.
Arch Linux (AUR)
Mise Browser is available on the Arch User Repository as mise-browser-bin.
Install using your preferred AUR helper:
yay -S mise-browser-binOr with paru:
paru -S mise-browser-binAlternatively, build and install manually with makepkg:
git clone https://aur.archlinux.org/mise-browser-bin.git
cd mise-browser-bin
makepkg -siLinux (Distro-Agnostic AppImage)
The AppImage runs out of the box on Ubuntu, Debian, Fedora, Arch Linux, openSUSE, and any standard modern Linux distribution without package managers or root privileges.
- Download the latest
Mise-<version>-x86_64.AppImage. - Make the file executable:bash
chmod +x Mise-*.AppImage - Run the AppImage directly:bash
./Mise-*.AppImage
The AppImage uses the static AppImage runtime, so it does not need libfuse2. It only requires FUSE, which almost every desktop distribution provides through fuse3. On systems without FUSE (such as minimal containers), execute the AppImage with the extract-and-run argument or unpack the package contents directly.
To integrate with desktop menus, you can also place the AppImage in your ~/Applications/ directory or use utilities such as AppImageLauncher (version 3 or newer).
macOS (DMG & Zip)
- Download the appropriate image for your Mac architecture:
- Apple Silicon (M1 / M2 / M3 / M4):
Mise-<version>-arm64.dmg - Intel processors:
Mise-<version>-x64.dmg
- Apple Silicon (M1 / M2 / M3 / M4):
- Open the
.dmgfile and drag Mise Browser into your Applications folder. - First-Launch Note: Because independent open-source projects do not carry paid enterprise code-signing certificates, macOS Gatekeeper may present an unverified developer dialog. Right-click Mise Browser in Finder and select Open, or run the following command in Terminal:bash
xattr -cr "/Applications/Mise Browser.app"
Windows (Portable & Setup Installer)
- Download either release artefact:
- Portable:
Mise-<version>-portable.exe(run directly from any folder, zero installation). - Setup Installer:
Mise-Setup-<version>.exe(installs to%LOCALAPPDATA%with a Start Menu entry).
- Portable:
- First-Launch Note: Windows SmartScreen may present a "Windows protected your PC" banner on freshly released binaries. Click More info followed by Run anyway.
Verifying Checksums
Every release includes a published SHA256SUMS.txt file containing cryptographic hashes for all released packages.
To verify download authenticity:
sha256sum -c SHA256SUMS.txtVerify that your downloaded file outputs OK.
Updating Mise
Mise includes an integrated, zero-privilege update notification system that checks the official GitHub Release ledger:
- Automated Check: Mise queries the GitHub Releases API shortly after startup. When a newer version is published, an update badge appears in the sidebar and Preferences view.
- Manual Check: Run Check for Updates in the Command Centre (
Ctrl+P) or click the Check for Updates button in Preferences (Ctrl+H). - Applying Updates:
- Arch Linux (AUR): Update alongside system packages (
yay -Syuorparu). - Linux AppImage: Download the latest
.AppImagefrom GitHub Releases and replace your existing file. - macOS / Windows: Download and run the latest installer or portable executable.
- Source Installs: Run
git pull && npm installin your repository folder.
- Arch Linux (AUR): Update alongside system packages (
Running from Source
If you prefer building and executing directly from source on Linux:
Prerequisites
Ensure your system has Node.js (v20 or newer) and npm installed.
On Arch Linux:
sudo pacman -S nodejs npmEnsure you have a terminal emulator installed for the clipboard-mediated terminal features (such as kitty, alacritty, foot, st, or xterm).
Setup & Launch
Clone the repository and navigate into the project directory:
bashgit clone https://github.com/Rakosn1cek/Mise-browser.git cd Mise-browserInstall dependencies:
bashnpm installLaunch Mise Browser:
bashnpm start
Alternatively, you can run the provided launcher script:
chmod +x launch.sh
./launch.shDesktop Environment Integration (Source Installs)
To integrate a source install directly into your desktop application launcher (such as Rofi, Wofi, or your desktop application menu) and deploy icons:
npm run install-desktopThis installs mise.desktop into ~/.local/share/applications/ and deploys icons across 48x48, 128x128, and 256x256 resolutions to ~/.local/share/icons/hicolor/.
Widevine DRM & Media Playback
Due to proprietary licensing restrictions, open-source browsers cannot bundle Google Widevine Content Decryption Module (CDM) binaries directly. Mise includes an automated detection helper that scans standard host locations on startup.
Linux
Mise automatically inspects host directories on startup for libwidevinecdm.so and manifest.json:
- Google Chrome:
/opt/google/chrome/WidevineCdm - Distribution packages:
/usr/lib/chromium/WidevineCdm,/usr/lib/widevine - User library directories:
~/.config/google-chrome/WidevineCdm,~/.local/lib/widevine
To enable protected media playback (such as Spotify Web Player or DRM video streams):
- Arch Linux: Install
widevineorchromium-widevinefrom the AUR:bashyay -S widevine - Other Distributions: Install Google Chrome, or set the
WIDEVINE_CDM_PATHenvironment variable pointing to your CDM directory.
You can verify detection status at any time in the Diagnostics overlay (via Command Centre Ctrl+P -> Open Diagnostics & System Health, or in Preferences Ctrl+H -> Diagnostics & System Health).
macOS & Windows
On macOS and Windows, Google enforces Verified Media Path (VMP) code-signing signatures. Protected DRM playback cannot function in vanilla open-source Electron builds on these operating systems. Mise detects this platform boundary and reports the status cleanly in Diagnostics without errors.
Configuration Location
All runtime configuration and persistent session data are stored locally in standard Linux XDG format:
~/.config/mise-browser/
├── config.json # Core engine and preference settings
├── keybinds.json # Customisable keyboard shortcuts map
├── session.json # Workspaces, open tabs, titles, and scroll offsets
├── bookmarks.json # Saved browser bookmarks
├── quickmarks.json # Single-key jump assignments
├── history.json # Actionable history entries
└── notes.md # Integrated markdown notes