> ## Documentation Index
> Fetch the complete documentation index at: https://docs-freessh.vercel.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install FreeSH and make your first remote connection in a few minutes.

### macOS

1. Visit the [FreeSH releases page](https://github.com/Adelodunpeter25/freessh/releases)
2. Download the latest `.dmg`
3. Open the file and drag FreeSH to Applications

#### First Launch

When you first open FreeSH, macOS may show a security warning because the app is not from the App Store.

1. Right-click FreeSH in Applications
2. Choose **Open**
3. Confirm **Open** in the dialog

### Windows

1. Visit the [FreeSH releases page](https://github.com/Adelodunpeter25/freessh/releases)
2. Download the latest `.msi`
3. Run installer and complete setup

### Linux

#### AppImage

1. Download latest `.AppImage` from releases
2. Make executable: `chmod +x FreeSH-*.AppImage`
3. Run: `./FreeSH-*.AppImage`

#### Debian/Ubuntu (`.deb`)

```bash theme={null}
sudo dpkg -i freessh_*.deb
sudo apt-get install -f
```