Skip to content

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.

6.2 KB
Raw Blame

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.