Client apps¶

Relay's web client works in a browser, as a Progressive Web App (PWA), or in the standalone desktop app. These clients connect to an existing Relay server; they do not deploy one.

Desktop App¶

Relay is also available as a standalone desktop app for users who want a native GUI client instead of using Relay in the browser. The app still connects to a Relay server URL, but it provides a native desktop experience without requiring users to manage their own self-hosted deployment.

The desktop client's Uploads settings can use either Relay storage or Catbox for public shareable links. This option is available only in the desktop build; browser and mobile PWA uploads continue using Relay storage.

Downloads¶

Release 0.10.5 includes Linux, Windows, and Apple Silicon macOS desktop artifacts.

Apple Silicon (.dmg)

macOS quarantine workaround

Current macOS builds are unsigned and not notarized, so Gatekeeper may quarantine Relay after each new release you install. If that happens, make sure Relay.app is in /Applications, then run:

xattr -dr com.apple.quarantine /Applications/Relay.app

Once Relay is properly Developer ID-signed and notarized, this workaround will no longer be needed.

Linux desktop build

The Linux desktop build is currently distributed as a .tar.gz archive. Extract it, enter the extracted directory, and run the bundled relay-desktop binary:

tar -xzf relay-desktop-linux-amd64.tar.gz
cd relay-desktop-linux-amd64
chmod +x relay-desktop
./relay-desktop

Download from the command line¶

curl -LO https://git.thc420.dev/ouch/relay/releases/download/0.10.5/relay-desktop-linux-amd64.tar.gz
curl -LO https://git.thc420.dev/ouch/relay/releases/download/0.10.5/relay-desktop-windows-amd64-installer.exe
curl -LO https://git.thc420.dev/ouch/relay/releases/download/0.10.5/relay-desktop-macos-arm64.dmg

Mobile App¶

Relay does not ship separate mobile builds. Instead, the Relay web client can be installed to your home screen as a Progressive Web App (PWA).

Open the Relay server URL you want to use on your device, then install it to your home screen. Do not install the docs site itself.

Relay also includes a built-in home screen install button under Settings > General > Native app, which can help trigger the install flow on supported browsers.

iPhone / iPad¶

Open your Relay server URL in Safari.
Tap the Share button.
Tap Add to Home Screen.
Confirm the app name and tap Add.

Android¶

Open your Relay server URL in a supported mobile browser. Chrome is the most common path for PWA install prompts on Android.
If the browser shows an install banner or Install app prompt, use it.
If no prompt appears, open the browser menu and choose Install app or Add to Home screen.
Confirm the install when prompted.

Note

Mobile PWA install behavior depends on the browser and device. On iPhone and iPad, installation is typically done from Safari's Share menu. On Android, install options may vary by browser, but Chrome is the most common experience.