Voxta docs
Voxta ServerGet Started

Update Voxta Server

Same path you used to install — the Voxta Desktop App installer auto-detects and upgrades your existing copy. Mobile and portable ZIP have slightly different paths.

How you update depends on how you installed. The Desktop App installer handles upgrades automatically. Portable ZIP users follow a slightly more manual process to preserve their data.

Just rerun the installer with the new version. It detects your existing install and upgrades it in place, keeping your Data/ folder intact.

Download the new installer

Sign in to portal.voxta.ai/downloads/voxta-server and grab the latest Voxta.DesktopApp.Setup.vX.Y.Z.exe.

Close Voxta if it's running

Shut down the Desktop App and check the system tray for any minimized instances.

Run the installer

Double-click the new .exe and follow the wizard. It auto-detects your existing install location and upgrades on top of it. Your characters, chats, scenarios, settings, and API keys are preserved.

Launch and update your modules

Launch Voxta. If the new version needs modules reinstalled, it says so at startup (Module updates required) — click Update all. You can also do it any time from Manage Modules → Upgrade All. See Module updates after upgrading.

Module updates after upgrading

When a Voxta release changes something modules depend on, it marks the affected ones as needing an update. They stay unusable until updated, and the startup screen lists them as Required. Update all reinstalls them in one pass. Only an administrator can run it.

The startup screen is one window with up to three steps, in order: migrations that need your attention, module updates, and a newer Voxta release. Next moves on, Done closes it. Closing it early skips the rest until the next launch.

Upgrading to 1.11 is one of those. The bundled Python moved to 3.14.7 on Windows, and Linux now expects a 3.14.6 venv. Either way it starts from an empty environment, so every Python-based module (local LLMs, TTS, STT, image generation…) has to install again. Expect a long first install — the dependencies are downloaded afresh. On Windows, once it succeeds, Voxta deletes the Python 3.12 and 3.13 folders earlier versions bundled, several GB each. Nothing else in Data/Python is touched.

Updating Voxta with Virt-A-Mate

If you use Voxta with Virt-A-Mate, update the VAM plugin at the same time. Plugin and server are released together, and mismatched versions can produce strange connection or behavior issues. See Update the Voxta plugin.

What's next

On this page