Skip to content

Install

Download from voltius.app or GitHub releases. Voltius is also on Google Play and the App Store.

winget (auto-updating):

winget install --id Voltius.Voltius -e

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):

curl -fsSL https://repo.voltius.app/setup.sh | sudo bash

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):

yay -S voltius-bin   # prebuilt binary, tracks releases

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):

flatpak install https://dl.flatpark.org/app.voltius.Voltius.flatpakref

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:

brew install --cask voltiusapp/voltius/voltius

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:

Get it on Google Play

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.

Download on the App Store

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.

git clone https://github.com/VoltiusApp/voltius
cd voltius && pnpm install && pnpm tauri build