Data folder and backups
Everything Relay keeps is in one folder:
| Install | Data folder |
|---|---|
| macOS | ~/Library/Application Support/Relay/data |
| Linux | ~/.config/Relay/data |
What’s inside
Section titled “What’s inside”| SQLite database | Events, replies, approvals, workspaces, actions, runs, settings, activity, token use. |
secrets.json |
API keys and tokens. Readable only by your account. |
credentials.json |
Store credentials. Readable only by your account. |
api-token |
The local API’s token. Readable only by your account. |
attachments/ |
Files from Slack, Linear, ClickUp and chat. |
backups/ |
Database copies made before upgrades. The last 5 are kept. |
| Logs | The server log and action run logs. |
Upgrades
Section titled “Upgrades”Before a new version changes the database’s structure, it copies the database to backups/. An older version refuses to open data from a newer one instead of risking it.
Export and import
Section titled “Export and import”Settings → Import & export saves your whole setup as one file: settings, workspaces with their actions, and saved views. Optionally include:
- keys and store credentials;
- the Activity log and chats (off by default: they’re history, not setup).
Importing it on another computer, or after a fresh install, replaces the manual setup steps. Import merges, never wipes:
- settings are replaced;
- workspaces, actions, views and credentials are matched by name, then updated or skipped;
- anything new is added;
- paths under the exporting user’s home folder move to your home folder.
Treat an export that includes keys like the keys themselves.