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 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.

What's next

On this page