Skip to main content

Uninstalling

Removing Delegaris takes three steps: put your machines back to normal, remove the program, and, if you are done with it for good, remove what you set up in AWS.

1. Put machines back on their schedules first​

While a machine is kept on, or a tag has been dropped, the schedule tag's value is held only in Delegaris's database. Removing Delegaris with its data loses those values, and the machines stay off their schedules.

Before uninstalling:

  1. On Resources, choose the Kept on filter. For each machine, open it and choose Put back on schedule (or Stop it now).
  2. Look for dropped tags (shown struck through in each resource's details) and Re-add them.
  3. Cancel any bookings still to come under Bookings (administrators can see everyone's).

If you are only reinstalling, or moving to a new server with the same data, you can skip this.

2. Remove the program​

Docker​

From the folder with your docker-compose.yml:

docker compose down # stop and remove the container; keeps the data volume
docker compose down -v # also delete the data volume: the database and backups
docker compose down --rmi all # also remove the Delegaris image, whichever tag you ran

Keep a copy of a recent backup (/data/backups in the volume, or your S3 bucket) and the encryption key (ENCRYPTION_KEY, or encryption.key in the volume) if you might want the data again.

If you ran several copies against PostgreSQL, drop the database when you no longer need it.

Linux package​

sudo /opt/delegaris/uninstall.sh

This stops and removes the service and the program, and keeps the settings (/etc/delegaris) and the data (/var/lib/delegaris), so installing again picks up where it left off.

To remove everything, including the database, its backups, the settings and the delegaris user:

sudo /opt/delegaris/uninstall.sh --purge

It asks you to type DELETE first (--yes skips the question, for scripts).

3. Remove what you set up in AWS​

Uninstalling changes nothing in your AWS accounts. If you will not use Delegaris again:

  • In each managed account: delete the stack made from member-account-role.yaml (by default delegaris-role), or the StackSet if you used one. That removes DelegarisRole. If you made the role by hand, delete the role.
  • In the account Delegaris ran in: delete the stack made from hub-role.yaml (the delegaris-hub role and instance profile), after detaching the instance profile from the server.
  • Access keys you created for Delegaris (for the service itself or for an account): deactivate and delete them in IAM.
  • IAM Identity Center: if Delegaris was signed in to Identity Center, nothing needs removing, but you can revoke its session from the Identity Center console.
  • Microsoft Entra ID: delete the app registration you made for sign-in.
  • Slack: remove the app from your workspace.
  • S3: buckets for backups or the activity log are yours; empty and delete them if you no longer need them.

Tags Delegaris put on resources are your own tags (Schedule and the like); it adds none of its own.