Cockpitify Help

Repair, update or remove an app

Keep Cockpitify's ops layer in your Supabase project up to date, repair a broken setup without losing data, or remove it completely.

Each connected app has an ops layer in its Supabase project. From Settings → Apps you can repair it, update it to the latest version, or remove it completely.

The app card

Each app in Settings → Apps shows its Supabase project, the ops version, a status and the last signal:

StatusWhat it means
HealthyEverything answers
DegradedSomething answers slowly or a part failed
Setup incompleteA part of the ops layer is missing; repair it
UnreachableThe project doesn’t answer; it may be paused
InstallingSetup is running
LockedLocked on your current plan

Tap the card for Setup health: the next step, problems, missing parts and Open in Supabase dashboard.

Update

When a new version is out, the card says New version ready and shows Update. New features often need it: a screen that says Update needed links here.

  1. Tap Update and approve Supabase access in the browser.
  2. Review the changes and tap Confirm and update.
  3. Wait for is up to date.

Repair

Repair reinstalls missing parts without deleting data. Use it when the status is Setup incomplete or a screen says the setup needs a repair.

  1. Tap Repair and approve Supabase access.
  2. Tap Confirm and repair and wait until it’s done.

Every repair and update asks for Supabase approval again, because the access key is deleted after each run.

Remove

Remove deletes the ops layer from your project entirely. Only the workspace owner can do it.

  1. Tap Remove, then Continue, and approve Supabase access.
  2. The Removal preview lists what is deleted: the ops schema and its data, the signing key in Vault, the functions and jobs. Your own tables, auth users and extensions are kept.
  3. Tap Confirm and remove.

Who can do what

  • Repair and Update: the owner and admins.
  • Remove: the owner.