Install#
Maystro is installed and updated by the Maystro Launcher, a small desktop application. You receive the installer link and your license key by e-mail after your access request is confirmed.
- Download and run
Maystro-Setup-latest.exefrom the link in your e-mail. - Open the launcher and choose Install. The install flow has seven steps:
| Step | What you decide |
|---|---|
| Location | The folder Maystro is installed into. Everything the app writes (settings, outputs, logs, the runtime environments) lives under this folder. Pick a fast drive with plenty of space. |
| Activation | Paste your license key (MAY-XXXX-XXXX). The launcher activates it against the Maystro server and stores the activation token locally. See Activate your license. |
| Version | The Maystro version to install. The list comes from the private package index your license unlocks; the newest version is preselected. |
| Configure | GPU selection. Pick the NVIDIA card Maystro should use. |
| Database | PostgreSQL host, port, database, user and password. Click Test Connection before you continue; see Requirements. |
| Review | A summary of your choices. Repair mode reinstalls Python and recreates the environment; leave it off for a fresh install. |
| Install | The launcher creates two managed Python environments: one for Maystro and one for the Vireo runtime, the engine that renders video and trains character LoRAs. |
- When the install finishes, click Launch. The launcher starts the backend and the Vireo runtime, then opens the Maystro workspace in its own window. External links open in your default browser.
Updates
The launcher checks the package index for new Maystro versions and offers them on the launch screen. The launcher itself checks for a newer build on start and asks before downloading it. The last version you installed keeps working even if you stop renewing.
If the install fails#
- Retry with Repair mode enabled on the Review step.
- Open the dev console from the bottom-left button of the launcher, run
uv cache clean, and retry. - Try a different install location.
- Still stuck: write to support@maystro.ai with the launcher log.