I want to install Mirrai on Windows
If you’re on Windows and would rather not install a database or touch the registry, this is how to get Mirrai installed with the installer.
Mirrai is open source, and all data stays local — everything lives under %APPDATA%\Mirrai and never leaves this machine.
What you need
- Windows x64
- No administrator rights required, no registry writes
- No need to install Node.js or PostgreSQL first — both are bundled
How to do it
1. Download the installer
Open the Mirrai GitHub Releases page and download Mirrai-Setup-x64.exe.
What you should see: the download completes and you have a Mirrai-Setup-x64.exe file.
2. Double-click to install
Double-click Mirrai-Setup-x64.exe and follow the prompts.
What you should see: the install finishes normally. No administrator rights are needed at any point, and there are no registry-related problems.
3. Start it from the Start menu
After installing, double-click Mirrai from the Start menu (or the desktop).
What you should see: a window with a progress bar opens and starts stepping through “initializing database → syncing schema → starting service → ready”.
4. Wait for “ready”
When the progress window finishes, open http://localhost:3000 in your browser.
What you should see: the Mirrai interface appears. The first visit walks you through creating a local account (username + password). Once you’re here, the install is done.
The first-start progress window
The first start takes a minute or two, and the progress window shows four stages in order:
- Initializing database
- Syncing schema
- Starting service
- Ready
What you should see: the four stages run one after another and end on “Ready”. Sitting still for a minute or two in between is normal — it is not a hang.
Where your data lives
Everything lives under %APPDATA%\Mirrai: the database, uploaded material, the persona, the farewell letter — all of it.
Uninstall via Settings → Apps, just like any other program. The install directory also carries Redis (in redis\); the app starts and stops it by itself, nothing for you to manage. To turn it off, put MIRRAI_REDIS=off in .env.
One known gotcha
PostgreSQL refuses to run as administrator on Windows. If you launched Mirrai from an elevated command prompt or terminal, start it again as a normal user.
What you should see: started as a normal user, the progress window runs all the way to “Ready”.
Want to build the installer yourself
powershell -ExecutionPolicy Bypass -File scripts\build-windows-app.ps1
Building the installer also needs Inno Setup. See docs/windows-build-guide.md in the repository.
What’s next
Once it’s installed, the first thing to do is usually upload chat history and distill them — see I want to upload chat history and distill them.