Skip to content

Uninstalling EasyTask

The interactive installer provides uninstall options for every component. Run the installer and choose the appropriate option from the menu.

Launch the Installer

cd ~/easytask
./easytask_installer.bin

The uninstall options are at the bottom of the menu:

============================================================
   EasyTask Installer V2
============================================================

  What would you like to do?

    ...
    6. Uninstall EasyTask (Full)
    7. Uninstall Scheduler Instance
    8. Uninstall Agent
    9. Uninstall Integration Server
    0. Exit

  Enter choice [0-9]:

Option 6 — Full Uninstall

Removes all EasyTask artifacts from the host. This includes:

  • All worker agent systemd services and configuration files
  • All application containers (scheduler, web backend, web UI, integration server, maintenance agent)
  • All infrastructure containers (PostgreSQL, KeyDB, Keycloak, OpenBao)
  • The podman pod and associated volumes
  • Generated certificates and configuration files
  • The pod systemd service
  Enter choice [0-9]: 6

  This will remove ALL EasyTask artifacts:
    - Worker agents (systemd services)
    - All containers (infra + app)
    - Pod, volumes, certs, generated configs

  Proceed? [y/N]: y

This action is destructive

Full uninstall removes all containers, volumes, and generated configuration. Database data is permanently deleted. Make sure you have backups of any important data before proceeding.

What the full uninstall does

Step Action
⅙ Stop all worker agent services
2/6 Remove agent files (env files, configs, binaries, systemd template)
3/6 Remove the pod systemd service
4/6 Remove all containers and the pod (with anonymous volumes)
⅚ Remove generated files (config, certs, OpenBao data)
6/6 Final cleanup check

What is preserved

  • The installer binary itself
  • The easytask_installer.json config file
  • Container images (not deleted, just containers removed)

Option 7 — Uninstall Scheduler Instance

Removes a specific scheduler container:

  Enter choice [0-9]: 7

  Removing scheduler container: easytask-scheduler-production
  Removed container: easytask-scheduler-production

Active workloads

Removing a scheduler stops all tasks currently assigned to it. Ensure no active workflows depend on the instance before uninstalling.

Option 8 — Uninstall Agent

Removes specific agent node(s). The installer shows installed agents and prompts for which to remove:

  Enter choice [0-9]: 8

  Installed agents: agent-01, agent-02
  Enter agent node names to uninstall (comma-separated): agent-02

  Stopping easytask-agent@agent-02...
  Removed: ~/easytask/config/agents/env_agent-02
  Uninstalled: agent-02
  Agent uninstall complete.

The uninstaller:

  1. Stops and disables the systemd service for each specified node
  2. Removes the node's environment file
  3. If no agents remain, cleans up the systemd service template

Option 9 — Uninstall Integration Server

Removes the integration server container:

  Enter choice [0-9]: 9

  Stopping easytask-intserver...
  Removed: easytask-intserver
  Integration server uninstall complete.

The uninstaller also removes integration server configuration from any existing agent environment files and restarts affected agents.

After Uninstalling

After removing components:

  • Partial uninstall (agents or integration server only) — remaining components continue to run normally
  • Full uninstall — the host is clean. To reinstall, follow the installation guide from the beginning

Frequently Asked Questions

Does full uninstall delete my database? Yes. The PostgreSQL container and its data are removed. Back up any important data before running a full uninstall.

Can I reinstall after a full uninstall? Yes. Run the installer again and select Option 1 to set up the infrastructure from scratch.

Can I uninstall just the agents and keep the infrastructure running? Yes. Use Option 8 to remove specific agent nodes, or Option 6 for a full cleanup.

What happens to my license certificates after uninstall? Generated config and certificate files are removed during a full uninstall. You will need to complete OTP verification again on the next install.