Installation

Verse ships as a native installer per platform. Downloads are listed under Portal → Downloads once a release is cut.

Supported platforms

• macOS :Apple Silicon (M Series) and Intel x86_64. macOS 12 Monterey or later.
• Windows :x64. Windows 10 22H2 or later.
• Linux :x86_64. .deb for Debian/Ubuntu (recommended) or AppImage elsewhere. Tested on Ubuntu 22.04/24.04 LTS and Fedora 39.

Step-by-step

1. Sign in to the portal and open Downloads.
2. Click the button that matches your operating system. The installer will download from a GitHub Releases mirror.
3. Run the installer:
   • macOS: open the .dmg and drag Verse to your Applications folder.
   • Windows: run the .exe installer and follow the prompts.
   • Linux (Debian/Ubuntu, recommended): sudo apt install ./Verse-x.y.z-amd64.deb, then launch Verse from your app menu.
   • Linux (AppImage, other distros): chmod +x Verse-x.y.z.AppImage and double-click to run. On Ubuntu 24.04 the AppImage also needs the FUSE 2 compat library: sudo apt install libfuse2t64.
4. Launch Verse. Paste the license key from Portal → Licenses when prompted.

Linux on Ubuntu 24.04: prefer the .deb — it sets up the Chromium sandbox correctly and "just works". The AppImage can hit a chrome-sandbox sandbox error on Ubuntu 24.04; see Troubleshooting → Linux won't launch if you must use it.

Activation

Verse uses an offline-first activation model. Once a device binds to a license key, it receives a 90-day activation token. The app keeps a rolling 30-day heartbeat window — if your machine can't reach api.verse.church for any reason, you can keep working for 30 days from the last successful heartbeat. The desktop app continues to work entirely offline until you need to revalidate.

If you replace a machine, deactivate the old device first via Portal → Devices so the seat returns to your license pool.

Code-signing

Early builds may be unsigned while we finalise code-signing. macOS users may need to right-click → Open the first time. Windows SmartScreen may warn; click More info → Run anyway.

Updates

Verse checks for updates on launch. Critical updates auto-install; feature updates prompt for confirmation. You can pin a version through Settings → Updates.

Uninstall

Before you uninstall, deactivate the device from Portal → Devices so the seat returns to your license pool — removing the app does not free the seat on its own (see Licenses & seats).

Then remove the app:

• macOS: quit Verse, then drag Verse from Applications to the Trash.
• Windows: Settings → Apps → Installed apps → Verse → Uninstall (or run Uninstall Verse from the install folder). The uninstaller removes the app and its Start-menu entries.
• Linux (.deb): sudo apt remove verse removes the app and unloads the bundled AppArmor profile; sudo apt purge verse does the same and also clears any package-level config. (Equivalent without apt: sudo dpkg -r verse / sudo dpkg -P verse.)
• Linux (AppImage): delete the Verse-x.y.z.AppImage file. If you added a launcher entry (e.g. via AppImageLauncher), remove that too.

Remove leftover data (optional)

Your settings, cache, the bundled Bible, and offline state live in a per-user folder that is kept by default, so a reinstall keeps your data. Delete it only for a clean slate:

• macOS: ~/Library/Application Support/Verse, ~/Library/Caches/Verse, ~/Library/Logs/Verse, and ~/Library/Preferences/com.penstackinc.apps.verse.plist.
• Windows: %APPDATA%\Verse and %LOCALAPPDATA%\Verse.
• Linux: ~/.config/Verse, ~/.cache/Verse, and ~/.local/share/Verse.

Verse keeps your license/credentials in your OS secret store. To purge them, remove any Verse entries from Keychain Access (macOS), Credential Manager → Windows Credentials (Windows), or your keyring app such as Passwords / Seahorse (Linux).