Skip to content

Install

Download from voltius.app or GitHub releases.

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

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

The app is signed with its own certificate but not notarized (no Apple Developer account yet), so macOS Gatekeeper warns on first launch — Control-click (right-click) Voltius.app and choose Open, then confirm. You only need to do this once.

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. On first launch, right-click Voltius.app → Open, or use System Settings → Privacy & Security → Open Anyway.

\"Voltius.app is damaged and cannot be opened\"

If macOS calls the app damaged (rather than showing the normal "unidentified developer" prompt), the copy picked up the quarantine flag — this applies to a Homebrew install as well as a downloaded .dmg. Strip the quarantine metadata and launch again:

xattr -dr com.apple.quarantine /Applications/Voltius.app

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.

Android is an early preview and there is no Play Store listing. 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.

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

Releases are all signed with the same key, so updates install over the top. 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.

Auto-updates

Voltius checks for updates on launch and prompts you when one is ready. Updates are signed with a bundled minisign key — no opt-out.

Linux packages installed from the apt/dnf repository update through your system package manager instead (apt upgrade / dnf upgrade, including unattended upgrades).

Android has no in-app updater. Obtainium polls the GitHub releases and offers each new version; a hand-sideloaded APK has to be replaced by hand.

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