Personal AI agent for macOS, Windows, Linux, Android & iOS. Set a goal, it works alone: coding (Skales Code), desktop + browser automation, autonomous scheduled Tasks. Teams of agents and humans across paired desktops. Agent2Agent, MCP, computer use, voice, local LLMs (Ollama), Agent Skills (SKILL.md). 26 AI providers, BYOK. No Docker, no terminal.
Skales — Linux Installation Guide
Ubuntu 24.04+ Sandbox Fix
On Ubuntu 24.04 and newer, the AppImage may fail to launch with:
setuid_sandbox_host.cc(158)] The SUID sandbox helper binary was found, but is not configured correctly.
This is caused by AppArmor restricting unprivileged user namespaces by default plus /tmp being mounted nosuid. Two workarounds:
Option A — Disable AppArmor restriction (persistent, system-wide):
echo "kernel.apparmor_restrict_unprivileged_userns=0" | sudo tee /etc/sysctl.d/60-apparmor-namespace.conf sudo sysctl -p /etc/sysctl.d/60-apparmor-namespace.conf
Option B — Run without sandbox (per-launch, less secure):
./Skales-x86_64.AppImage --no-sandbox
Older Ubuntu (22.04 and earlier) runs the AppImage without these steps.
Skales — Linux Installation Guide (old - v7)
Linux support is in Beta. Core features work well on major distros. See Known Issues below for edge cases.
Download
Download from skales.app or GitHub Releases.
Two formats are available:
| Format | Best for |
|---|---|
| AppImage (recommended) | Any distro — Ubuntu, Fedora, Arch, Manjaro, Mint, etc. |
| .deb | Debian, Ubuntu, and derivatives (apt-based) |
Filenames follow the pattern Skales-<version>-x64.AppImage / Skales-<version>-x64.deb. Replace <version> with the version you downloaded.
Prerequisites
- FUSE (required for AppImage on some distros):
sudo apt install fuse libfuse2 # Debian / Ubuntu sudo dnf install fuse fuse-libs # Fedora
AppImage (Recommended)
Works on any distro without installation. No root required.
# Make executable and run
chmod +x Skales-<version>-x64.AppImage
./Skales-<version>-x64.AppImage
To add to your application launcher, create a .desktop file:
cat > ~/.local/share/applications/skales.desktop << 'EOF'
[Desktop Entry]
Name=Skales
Exec=/path/to/Skales-<version>-x64.AppImage
Icon=skales
Type=Application
Categories=Utility;Development;
EOF
Ubuntu 24.04+ and the AppArmor sandbox
Ubuntu 24.04 and later (and a growing number of other distros) ship with kernel option kernel.apparmor_restrict_unprivileged_userns=1, which blocks unprivileged user namespaces. The Chromium sandbox that Electron uses depends on user namespaces, so the AppImage would fail to launch without intervention.
Automatic fallback (default): Skales detects this restriction at startup and falls back to --no-sandbox so the app launches reliably. A log line is printed at startup when the fallback is active.
Full sandbox (optional, recommended): to keep the Chromium sandbox enabled, install an AppArmor profile that exempts the Skales binary. Save the snippet below as /etc/apparmor.d/skales, then reload AppArmor.
# /etc/apparmor.d/skales
abi <abi/4.0>,
include <tunables/global>
profile skales /opt/Skales/skales flags=(unconfined) {
userns,
include if exists <local/skales>
}
sudo apparmor_parser -r /etc/apparmor.d/skales
If you launch the AppImage from a different path, adjust the profile path to match. Restart Skales after installing the profile.
.deb Package (Debian / Ubuntu)
# Install the package
sudo dpkg -i Skales-<version>-x64.deb
# Fix any missing dependencies
sudo apt-get install -f
# Launch
skales
Auto-Start on Login
Skales does not configure auto-start automatically on Linux. To start Skales on login:
mkdir -p ~/.config/autostart
cat > ~/.config/autostart/skales.desktop << 'EOF'
[Desktop Entry]
Name=Skales
Exec=/path/to/Skales-<version>-x64.AppImage
Type=Application
X-GNOME-Autostart-enabled=true
EOF
Ollama (Local AI — Recommended)
Skales detects Ollama automatically on launch. To install:
curl -fsSL https://ollama.com/install.sh | sh
Pull a model to get started:
ollama pull llama3.2
# or for a larger model:
ollama pull qwen2.5:7b
Skales will auto-detect Ollama at http://localhost:11434 when you select the Ollama provider in onboarding. For remote Ollama, set the URL in Settings → AI Models → Ollama → Base URL.
System Tray
On GNOME, the system tray requires an extension:
# Install AppIndicator extension
sudo apt install gnome-shell-extension-appindicator # Ubuntu/Debian
# Then enable it in GNOME Extensions
On KDE Plasma, XFCE, and i3/Sway with a compatible bar (e.g. waybar), the tray works without additional setup.
Known Issues (Beta)
| Issue | Workaround |
|---|---|
| Desktop Buddy floating window may behave unexpectedly on tiling WMs (i3, Sway, Hyprland) | Disable Desktop Buddy in Settings → Desktop App if it causes layout issues |
| System tray icon missing on stock GNOME | Install AppIndicator extension (see above) |
| Auto-start not configured automatically | Create a .desktop file in ~/.config/autostart/ (see above) |
| FUSE required for AppImage on some distros | sudo apt install fuse libfuse2 (covered in Prerequisites above) |
| Ubuntu 24.04+ blocks Chromium sandbox via AppArmor | Auto-detected; Skales falls back to --no-sandbox. Install the AppArmor profile above to keep the sandbox enabled |
| Wayland: some popup windows may flicker | Launch with ELECTRON_OZONE_PLATFORM_HINT=wayland prefix |
Data Location
All Skales data (memory, settings, API keys, credentials) is stored in:
~/.skales-data/
This folder persists across updates and uninstalls. Back it up to preserve your configuration.
Uninstall
AppImage: Simply delete the .AppImage file. Remove ~/.skales-data/ to wipe all data.
.deb:
sudo dpkg -r skales
# To also remove data:
rm -rf ~/.skales-data/
Feedback & Bug Reports
Linux-specific issues: github.com/skalesapp/skales/issues
Please include your distro, desktop environment, and display server (X11 or Wayland) in bug reports.