# Installation

Source: https://athas.dev/docs/installation

Install Athas on macOS, Windows or Linux, choose a package, and safely uninstall it.

Choose the build for your operating system and CPU architecture from [Download Athas](https://athas.dev/download).
Use stable releases for everyday work; see [Updates](https://athas.dev/docs/updates) for upgrades.

## Quick Install

### macOS / Linux

```bash
curl -fsSL https://athas.dev/install.sh | sh
```

If you prefer `wget`:

```bash
wget -qO- https://athas.dev/install.sh | sh
```

### Windows

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://athas.dev/install.ps1 | iex"
```

The install script detects your OS and architecture, downloads the latest stable
release from GitHub by default, verifies the SHA256 checksum when available, and
installs it. To install a specific release, pass its version:

```bash
curl -fsSL https://athas.dev/install.sh | sh -s -- --version 0.15.1
```

On macOS, the script installs Athas to `/Applications`. On Linux, it installs the
app bundle to `~/.local/share/athas/athas.app` and links the executable at
`~/.local/bin/athas`.

On Linux, Athas uses the system WebKitGTK 4.1. The script checks for it and, if
it is missing, prints the command to install it instead of installing an app
that cannot start:

| Distribution   | Package               |
| -------------- | --------------------- |
| Debian, Ubuntu | `libwebkit2gtk-4.1-0` |
| Fedora         | `webkit2gtk4.1`       |
| Arch Linux     | `webkit2gtk-4.1`      |
| openSUSE       | `libwebkit2gtk-4_1-0` |

**Info:**

You can inspect the script before running it:

```bash
curl -fsSL https://athas.dev/install.sh | less
```

## Linux Package Repositories

Athas publishes signed APT and DNF repositories for x64 and ARM64. Once the repository is set up,
your system package manager installs Athas and picks up each stable release with its regular
upgrades.

### APT (Debian, Ubuntu)

Add the signing key and the repository, then install Athas:

```bash
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://athas.dev/apt/athas.gpg | sudo tee /etc/apt/keyrings/athas.gpg > /dev/null
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/athas.gpg] https://athas.dev/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/athas.list > /dev/null
sudo apt update
sudo apt install athas
```

Update Athas with the rest of your system:

```bash
sudo apt update && sudo apt upgrade
```

### DNF (Fedora, RHEL)

Add the repository, then install Athas:

```bash
sudo curl -fsSL https://athas.dev/rpm/athas.repo -o /etc/yum.repos.d/athas.repo
sudo dnf install athas
```

The first time, DNF asks you to import the repository signing key. Accept it after checking
that the fingerprint matches the one below.

Update Athas with the rest of your system:

```bash
sudo dnf upgrade
```

Both repositories are signed with the Athas Packages key (`packages@athas.dev`), fingerprint
`9D96 7A0C 00D8 DC21 1F23  695B 9548 A14F 4E5A 0666`. They track stable releases only, and the
package files are the same ones attached to each GitHub release.

## Package Managers

  

### Homebrew

```bash
brew install --cask athas
```

  

### Arch Linux (AUR)

```bash
yay -S athas-bin
```

The Homebrew cask and the `athas-bin` AUR package are maintained by the community. Athas does not
publish a Nix package; community packages may exist. WinGet and Scoop
packages are on the way; until then use the PowerShell command above or the Windows installer.

## Manual Download

Download the latest version from GitHub releases:

**[Download from GitHub Releases](https://github.com/athasdev/athas/releases)**

### macOS

1. Download the `.dmg` file from [releases](https://github.com/athasdev/athas/releases)
2. Open the downloaded file
3. Drag Athas to your Applications folder
4. Open Athas from Applications

### Windows

1. Download the NSIS `.exe` or `.msi` installer from [releases](https://github.com/athasdev/athas/releases)
2. Run the installer
3. Follow the installation wizard
4. Launch Athas from the Start Menu

### Linux

Download the package for your distribution and architecture (x64 or ARM64)
from the [download page](https://athas.dev/download) or
[releases](https://github.com/athasdev/athas/releases).

The AppImage runs on most distributions without installing anything. If it
does not start, install FUSE 2 (`libfuse2`):

```bash
chmod +x Athas_*.AppImage
./Athas_*.AppImage
```

Debian and Ubuntu:

```bash
sudo apt install ./Athas_*_amd64.deb
```

Fedora and other RPM-based distributions:

```bash
sudo dnf install ./Athas-*.rpm
```

The portable `.tar.gz` bundle needs no system-wide installation, but it
uses the system WebKitGTK 4.1 (see the table above for the package name):

```bash
tar -xzf Athas_*_linux-*.tar.gz
./athas.app/bin/athas
```

To make `athas` available from your shell:

```bash
mkdir -p ~/.local/share/athas ~/.local/bin
mv athas.app ~/.local/share/athas/athas.app
ln -sf ~/.local/share/athas/athas.app/bin/athas ~/.local/bin/athas
```

Athas does not publish a Flatpak; community packages may exist.

## Verify the install

Open Athas, open a project folder, save a test file, and open the terminal. Install the shell command
from **Settings > General > Terminal Command**, then run `athas --help` in a new shell.
If the app will not launch, record the exact error and package format for [Troubleshooting](https://athas.dev/docs/troubleshooting).

## Uninstall

Quit Athas before uninstalling. Removing user-data directories also removes local settings and
history; export or back up anything you want to keep first. Removing only the application preserves
its user data. Use the package manager that installed the app when possible.

### macOS

```bash
rm -rf /Applications/Athas.app
```

Optional: permanently remove local settings/history and cache after backing them up:

```bash
rm -rf ~/Library/Application\ Support/com.code.athas
rm -rf ~/Library/Caches/com.code.athas
```

### Windows

Uninstall from **Settings > Apps > Installed apps** or run the uninstaller
from the Start Menu.

Optional: permanently remove remaining user data after backing it up:
```powershell
Remove-Item -Recurse -Force "$env:APPDATA\com.code.athas"
```

### Linux

If installed by the quick install script:

```bash
rm -f ~/.local/bin/athas
rm -rf ~/.local/share/athas/athas.app
rm -f ~/.local/share/applications/com.code.athas.desktop
```

If installed from a native package:

```bash
sudo apt remove athas
# or
sudo dnf remove athas
```

If you added the Athas package repository, remove it as well:

```bash
sudo rm -f /etc/apt/sources.list.d/athas.list /etc/apt/keyrings/athas.gpg
# or
sudo rm -f /etc/yum.repos.d/athas.repo
```

The AppImage is a single file; delete it to remove Athas.

    Optional: permanently remove application data after backing it up:
```bash
rm -rf ~/.local/share/com.code.athas
rm -rf ~/.config/com.code.athas
```