Skip to content

Installation

Se.Cherkasov edited this page Aug 23, 2026 · 1 revision

Installation

English · Русский

Packages

Everything is attached to the latest release.

Platform Arch Files
Linux x86_64 .deb, .rpm, .AppImage
Linux arm64 .deb, .rpm, .AppImage
Windows x64 .msi, .zip
macOS Apple Silicon .dmg
macOS Intel .dmg
Android arm64-v8a .apk

There is no iOS/iPadOS build — the project has no iOS targets.

# Linux
sudo dpkg -i skerry_*.deb        # Debian/Ubuntu
sudo rpm -i skerry-*.rpm         # Fedora/RHEL
chmod +x Skerry-*.AppImage && ./Skerry-*.AppImage

Verify the download

sha256sum -c --ignore-missing SHA256SUMS.txt

Unsigned builds

Builds are not code-signed — there is no Apple Developer account and no Windows certificate.

  • macOS — Gatekeeper blocks the first launch. Right-click the app → Open, or allow it under System Settings → Privacy & Security. The bundle version reads 1.x.y because packaging requires a major version ≥ 1; the real version is on the About screen.
  • Windows — SmartScreen warns on the first run of the .msi. More info → Run anyway.
  • Android — the .apk is signed with the project key, but it is not distributed through Google Play, so installing it needs "install unknown apps" for the browser or file manager you download it with.

Updates

Settings → About → Check for updates asks the GitHub Releases API once a day and shows a link to the release page when a newer version exists. Nothing is downloaded or installed automatically.

Where data lives

What Path
Config, vault, known hosts (desktop) $XDG_CONFIG_HOME/skerry, default ~/.config/skerry — on every desktop OS, Windows included (%USERPROFILE%\.config\skerry)
Downloaded local-AI models (desktop) $XDG_DATA_HOME/skerry, default ~/.local/share/skerry
Everything (Android) app-private storage

The config directory is created with mode 0700, and secret-bearing files inside it are written atomically with 0600. That directory is the whole local state: back it up, and remember that there is no password recovery — see Vault and credentials.

To run a second isolated instance on Linux, point XDG_CONFIG_HOME somewhere else before launching.

Building from source

See Building and running.

Clone this wiki locally