Install¶
Download from voltius.app or GitHub releases. Voltius is also on Google Play and the App Store.
winget (auto-updating):
SmartScreen may warn that the publisher is unverified (the app is not yet code-signed) — choose More info → Run anyway.
Or download an installer:
Voltius_x.y.z_x64-setup.exe— NSIS installer (recommended)Voltius_x.y.z_x64_en-US.msi— MSI for managed deployments
ARM64 builds are published with an arm64 suffix (Voltius_x.y.z_arm64-setup.exe, Voltius_x.y.z_arm64_en-US.msi).
When local network sync first starts, Windows asks once whether Voltius may use the network: allow it on private networks. See the one-time system prompt.
Recommended — apt / dnf repository (signed, and updated through your package manager):
This adds the Voltius repo and installs the app; afterwards it stays current via sudo apt upgrade / sudo dnf upgrade. Per-distro and manual steps are in the README. amd64/x86_64 and arm64/aarch64 are both provided.
Or download a single package:
.deb(Debian/Ubuntu):sudo apt install ./Voltius_*.deb.rpm(Fedora/RHEL):sudo dnf install ./Voltius-*.rpm.AppImage(portable):chmod +x Voltius_*.AppImage && ./Voltius_*.AppImage
Arch — AUR (community-maintained by ezhkov, not published by this repo's CI):
voltius (source build) and voltius-git (latest main) are also on the AUR. If any of these fall behind, the apt/dnf repo above is the maintained fallback.
Flatpak — FlatPark (community-maintained by jing2uo, not published by this repo's CI):
It installs the official .deb unmodified and follows releases automatically; x86_64 only for now. The local terminal opens your shell on the host, just like outside the sandbox. See the FlatPark page.
Recommended — Homebrew:
Voltius is signed and notarized by Apple, so it opens like any other app. After updating from an older version, macOS asks once for access to the keychain: choose Always Allow.
Or download the .dmg for your chip:
Voltius_x.y.z_aarch64.dmg— Apple Silicon (M1 and later)Voltius_x.y.z_x64.dmg— Intel
Open the .dmg, then drag Voltius.app into /Applications.
When local network sync first starts, macOS asks once for Local Network access: allow it so your devices can find each other. See the one-time system prompt.
Don't download voltius_darwin_*
The extensionless voltius_darwin_aarch64 / voltius_darwin_x64 files are raw binaries for advanced/CLI use, not the app. macOS opens them as text if you double-click them — grab the .dmg instead.
The build needs Android 7.0+ and is arm64-v8a only — every current phone, but not x86_64 emulators or Chromebooks. Local terminal and serial console are unavailable on the platform; remote SSH and SFTP are the point here. Local network sync runs while the app is open, and SFTP can browse the files of your other devices (My devices).
Recommended — Obtainium (auto-updating): it watches the GitHub releases and installs new versions like a store would.
Add Voltius to Obtainium — open that link on the phone and it fills the Add App screen in; on a desktop browser it offers Obtainium itself instead. By hand, it is Add App → https://github.com/VoltiusApp/voltius.
Android asks you to allow Install unknown apps for Obtainium the first time. Obtainium's update checks use the unauthenticated GitHub API, capped at 60 requests/hour per IP address — if they start failing, add a personal access token under Settings → Source-specific → GitHub.
Or from Google Play, which updates the app like any other:
Or sideload by hand: download Voltius_x.y.z_aarch64.apk, allow Install unknown apps for your browser or file manager, and open it. Updates are manual that way.
Every APK must come from the same source
The GitHub APKs and the Google Play build are all signed with the same key, so one updates over the other. An APK from anywhere else — including one you built yourself — fails with INSTALL_FAILED_UPDATE_INCOMPATIBLE and has to be uninstalled first, which takes its local data with it.
Install Voltius SSH from the App Store. It runs on iPhone with iOS 16+ and updates through the App Store. As on Android, the local terminal and serial console are desktop-only; remote SSH and SFTP are the point here.
Not available in France yet
The App Store listing excludes France until Apple approves the French encryption declaration.
Auto-updates¶
Voltius checks for updates shortly after launch and every 4 hours, downloads new versions in the background, and flags a ready update on the What's new button at the bottom of the vault sidebar — restart from there, or (except on Windows) it installs when you quit. Updates are verified against a bundled minisign key. To stop the background downloads, turn off Settings → About → Auto-download updates; Voltius still checks and tells you when a version is available.
Linux packages installed from the apt/dnf repository update through your system package manager instead (apt upgrade / dnf upgrade, including unattended upgrades).
Android and iOS have no in-app updater. On Android, Obtainium polls the GitHub releases and offers each new version, Google Play updates its own install, and a hand-sideloaded APK has to be replaced by hand. On iOS, the App Store updates the app.
Build from source¶
AGPLv3. See CONTRIBUTING.md. Requires Node.js 24+, pnpm, Rust, and Tauri prerequisites.
