Install
1
Download
Get the installer for your OS at heygaia.io/download.
2
Install
Open the file. On macOS, drag GAIA into Applications.
3
Sign in
Click Sign In. Your browser opens, and the app picks up your session when you finish.
Updates
The app checks for updates on launch. When one is ready, restart now or on your next quit.Updates come from GitHub Releases. If your network blocks GitHub, allow
github.com.Connect your computer to GAIA
The desktop app can let GAIA run commands on this computer. See Device Bridge.Troubleshooting
Blank screen after launch
Blank screen after launch
The app’s internal server may still be starting. Wait up to 15 seconds, then quit and relaunch. Make sure nothing else uses ports 5174 to 5180.
No update prompt
No update prompt
Allow outbound HTTPS to
github.com. Corporate proxies can block the update check.Sign-in doesn't return to the app
Sign-in doesn't return to the app
Your OS must have the
gaia:// protocol registered. On Linux, .deb and .rpm installs do this for you. With the AppImage, launch the app once.App won't load after an update
App won't load after an update
Delete the app data folder and relaunch. You will need to sign in again.
- macOS:
~/Library/Application Support/GAIA - Windows:
%APPDATA%/GAIA - Linux:
~/.config/GAIA

