Skip to content

Uninstalling and resetting

Offsite keeps itself in one directory plus a few named services, so removing it is short. Do it in this order — stopping the services after deleting their files leaves orphaned jobs behind.

From the app, end the sessions you care about cleanly. Anything still running in tmux will otherwise be killed with the agent.

In the app, switch off always reachable and hand sleep control back with Allow host sleep. That is the supported path and it removes the services properly.

If the app is already gone, clean up by hand. Find what is actually installed rather than guessing at names — Offsite installs several helpers and their labels differ between builds:

Terminal window
# macOS — what is registered
launchctl list | grep -i offsite
ls ~/Library/LaunchAgents | grep -i offsite
ls /Library/LaunchDaemons | grep -i offsite

Then unload and delete what you found:

Terminal window
# user agents
launchctl bootout "gui/$(id -u)/<label>"
rm ~/Library/LaunchAgents/<label>.plist
# the privileged sleep helper, if you installed it
sudo launchctl bootout system/com.rapidrocket.offsite.power-helper
sudo rm -f /Library/LaunchDaemons/com.rapidrocket.offsite.power-helper.plist
sudo rm -f /Library/PrivilegedHelperTools/com.rapidrocket.offsite.power-helper
Terminal window
# Linux
systemctl --user list-units | grep -i offsite
systemctl --user disable --now <unit>
loginctl disable-linger "$USER" # only if you enabled it for Offsite
Terminal window
rm -rf ~/.offsite

That removes the host agent, session state, uploads, archives, action memory, deploy artefacts and Offsite’s tmux config in one go. See What Offsite puts on your machine for what each of those was.

Your repositories are untouched — Offsite never wrote into them.

  • macOS: quit Offsite and delete it from Applications.
  • iOS: delete the app.

If you used Computer Use, remove the Agent Bridge from System Settings › Privacy & Security › Screen Recording and Accessibility. Local Network permission for the app lives under Privacy & Security › Local Network.

You do not need to uninstall to get a clean host. Deleting ~/.offsite and running setup again rebuilds everything; the app reinstalls the host components.

Deleting a workspace in the app removes only Offsite’s record of it — the folder on disk stays.

  • Paired devices live in the host’s devices.json; deleting the state directory de-authorises every device, and they will need a fresh QR code afterwards.
  • Client-side host profiles and credentials are in the system keychain and are removed with the app.
  • Offsite never modified your ~/.tmux.conf, your ~/.ssh or your shell configuration, so there is nothing to undo there.
  • Remote Login, if you enabled it to set up a remote Mac, was your change — turn it off in System Settings › General › Sharing if you no longer want it.