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 run service installers
After the upgrade, launch Voxta. Then go to Manage Services → Run All Installers so any service modules that bumped Python deps between versions get refreshed.
ZIP users have to handle the Data/ folder copy manually since there's no installer to do it for them.
Download the new ZIP
From the portal Downloads page, grab the latest portable ZIP for your edition:
- Full portable —
Voxta.DesktopApp.vX.Y.Z.zip - Lite —
Voxta.DesktopAppLite.vX.Y.Z.zip - Linux —
Voxta.Server.Linux.vX.Y.Z.zip
Close every running Voxta instance
Shut down Desktop App and any Voxta.Server.exe processes. Check the system tray too.
Extract the new release into a new empty folder
Do not unzip on top of your existing install. Stale DLLs from the old version will conflict with the new one. New folder, every time. Use a sibling folder like C:\Voxta\v1.X.Y so you can keep the previous version as a rollback.
Copy your Data folder across
From the old install, copy the entire Data folder into the new install (replacing the empty one).
The most critical file is Data/Voxta.db — it holds your characters, chats, scenarios, memory books, settings, and API keys.
Launch the new version
Run Voxta.DesktopApp.exe (or Voxta.Server.exe) from the new folder.
Run all service installers
Manage Services → Run All Installers — re-installs Python deps for every service so anything that bumped versions gets refreshed.
Delete the old install
Once the new version is confirmed working, delete the previous folder. Data has moved over via the Data copy.
Mobile updates are a simple over-the-top APK install — Android handles the upgrade and preserves your app data.
Download the new APK
On your phone, open portal.voxta.ai/downloads/voxta-server in your browser. Tap the latest ai.voxta.mobile.vX.Y.Z-Signed.apk to download.
Install over the existing version
Tap the downloaded APK. Android recognizes it as an update to the installed Voxta app and prompts you to confirm. Accept — your chats, settings, and API key are preserved.
Launch
Open Voxta. You're on the new version. No further steps needed.
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.