linux.md

Linux Installation & Building Guide

This guide covers Linux-specific installation options and building from source.

Flatpak Installation

Flatpak packages are available for Linux users who prefer sandboxed applications.

Download Flatpak

See the main README for Flatpak download links in the Beta Release section.

Building Flatpak from Source

To build the Flatpak package yourself, you need additional dependencies:

# Fedora/RHEL
sudo dnf install flatpak-builder

# Ubuntu/Debian
sudo apt install flatpak-builder

# Install required Flatpak runtimes
flatpak install flathub org.freedesktop.Platform//25.08 org.freedesktop.Sdk//25.08
flatpak install flathub org.electronjs.Electron2.BaseApp//25.08

# Build the Flatpak
cd apps/frontend
npm run package:flatpak

The Flatpak will be created in apps/frontend/dist/.

Installing the Built Flatpak

After building, install the Flatpak locally:

flatpak install --user apps/frontend/dist/Auto-Claude-*.flatpak

Running from Flatpak

flatpak run com.autoclaude.AutoClaude

Other Linux Packages

AppImage

AppImage files are portable and don't require installation:

# Make executable
chmod +x Auto-Claude-*-linux-x86_64.AppImage

# Run
./Auto-Claude-*-linux-x86_64.AppImage

Debian Package (.deb)

For Ubuntu/Debian systems:

sudo dpkg -i Auto-Claude-*-linux-amd64.deb

Troubleshooting

Flatpak Runtime Issues

If you encounter runtime issues with Flatpak:

# Update runtimes
flatpak update

# Check for missing runtimes
flatpak list --runtime

AppImage Not Starting

If the AppImage doesn't start:

# Check for missing libraries
ldd ./Auto-Claude-*-linux-x86_64.AppImage

# Try running with debug output
./Auto-Claude-*-linux-x86_64.AppImage --verbose