> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/web-application-and-api-protection-waap/application-security-testing/ast-basics-and-workflow/runners-and-cli/uninstalling-a-runner.md).

# Uninstalling a Runner

Uninstalling a runner depends on how the runner was originally deployed. The following tabs highlight the steps to ensure that runners are successfully uninstalled from your environment without leaving residual services or configurations.

{% hint style="info" %}
A deleted runner cannot be restored.
{% endhint %}

{% tabs %}
{% tab title="Installed using `install.sh`" %}

<details>

<summary>Option 1 - As a systemd service</summary>

Complete the following steps:

1. Specify the following command to stop the service if it is currently running:

   ```language-bash
   sudo systemctl stop traceable-runner.service
   ```
2. Specify the following command to check the status of the service:

   ```language-bash
   sudo systemctl status traceable-runner.service
   ```

   The above command and recent log entries show whether the service is active, inactive, or has failed.
3. Specify the following command to disable the service:

   ```language-bash
   sudo systemctl disable traceable-runner.service
   ```

   The above command prevents the service from starting automatically at boot time.
4. Specify the following command to remove the service unit file from your custom location:

   ```language-bash
   sudo rm /etc/systemd/system/traceable-runner.service
   ```

   The above command removes the file from the `/etc/systemd/system` directory. This directory usually contains the `systemd` service files created or customized by the system administrator.
5. Specify the following command to remove the service unit file from the standard location:

   ```language-bash
   sudo rm /user/lib/systemd/system/traceable-runner.service
   ```

   The above command removes the file from the `/user/lib/systemd/system/` directory. This directory usually contains `systemd` service files provided by installation packages.
6. Specify the following command to reload the `systemd` manager configuration:

   ```language-bash
   sudo systemctl daemon-reload
   ```

   The above command reloads the manager configuration. You must run this command to ensure that `systemd` is aware of the above steps.

</details>

<details>

<summary>Option 2 - Not as a service</summary>

Complete the following steps:

1. Specify the following command to stop the runner:

   ```language-bash
   traceable runner stop <runner_name>
   ```
2. Ensure that the Traceable runner process is currently not running:

   ```language-bash
   ps -ef | grep traceable
   ```
3. Specify the following command to remove the Traceable CLI installation:

   ```language-bash
   delete $HOME/.local/traceable directory
   ```

</details>

Enter the following command to uninstall the runner:

```language-bash
helm uninstall <deployment_name>
```

Complete the following steps:

1. Open your web browser and log in to the AWS management console.
2. In the console, navigate to the **Amazon Elastic Container** Service.
3. Click the cluster where you installed the runner.
4. Delete the runner service.
   {% endtab %}

{% tab title="Installed using Helm chart" %}

<details>

<summary>Option 1 - As a systemd service</summary>

Complete the following steps:

1. Specify the following command to stop the service if it is currently running:

   ```language-bash
   sudo systemctl stop traceable-runner.service
   ```
2. Specify the following command to check the status of the service:

   ```language-bash
   sudo systemctl status traceable-runner.service
   ```

   The above command and recent log entries show whether the service is active, inactive, or has failed.
3. Specify the following command to disable the service:

   ```language-bash
   sudo systemctl disable traceable-runner.service
   ```

   The above command prevents the service from starting automatically at boot time.
4. Specify the following command to remove the service unit file from your custom location:

   ```language-bash
   sudo rm /etc/systemd/system/traceable-runner.service
   ```

   The above command removes the file from the `/etc/systemd/system` directory. This directory usually contains the `systemd` service files created or customized by the system administrator.
5. Specify the following command to remove the service unit file from the standard location:

   ```language-bash
   sudo rm /user/lib/systemd/system/traceable-runner.service
   ```

   The above command removes the file from the `/user/lib/systemd/system/` directory. This directory usually contains `systemd` service files provided by installation packages.
6. Specify the following command to reload the `systemd` manager configuration:

   ```language-bash
   sudo systemctl daemon-reload
   ```

   The above command reloads the manager configuration. You must run this command to ensure that `systemd` is aware of the above steps.

</details>

<details>

<summary>Option 2 - Not as a service</summary>

Complete the following steps:

1. Specify the following command to stop the runner:

   ```language-bash
   traceable runner stop <runner_name>
   ```
2. Ensure that the Traceable runner process is currently not running:

   ```language-bash
   ps -ef | grep traceable
   ```
3. Specify the following command to remove the Traceable CLI installation:

   ```language-bash
   delete $HOME/.local/traceable directory
   ```

</details>

Enter the following command to uninstall the runner:

```language-bash
helm uninstall <deployment_name>
```

Complete the following steps:

1. Open your web browser and log in to the AWS management console.
2. In the console, navigate to the **Amazon Elastic Container** Service.
3. Click the cluster where you installed the runner.
4. Delete the runner service.
   {% endtab %}

{% tab title="Installed on AWS ECS" %}

<details>

<summary>Option 1 - As a systemd service</summary>

Complete the following steps:

1. Specify the following command to stop the service if it is currently running:

   ```language-bash
   sudo systemctl stop traceable-runner.service
   ```
2. Specify the following command to check the status of the service:

   ```language-bash
   sudo systemctl status traceable-runner.service
   ```

   The above command and recent log entries show whether the service is active, inactive, or has failed.
3. Specify the following command to disable the service:

   ```language-bash
   sudo systemctl disable traceable-runner.service
   ```

   The above command prevents the service from starting automatically at boot time.
4. Specify the following command to remove the service unit file from your custom location:

   ```language-bash
   sudo rm /etc/systemd/system/traceable-runner.service
   ```

   The above command removes the file from the `/etc/systemd/system` directory. This directory usually contains the `systemd` service files created or customized by the system administrator.
5. Specify the following command to remove the service unit file from the standard location:

   ```language-bash
   sudo rm /user/lib/systemd/system/traceable-runner.service
   ```

   The above command removes the file from the `/user/lib/systemd/system/` directory. This directory usually contains `systemd` service files provided by installation packages.
6. Specify the following command to reload the `systemd` manager configuration:

   ```language-bash
   sudo systemctl daemon-reload
   ```

   The above command reloads the manager configuration. You must run this command to ensure that `systemd` is aware of the above steps.

</details>

<details>

<summary>Option 2 - Not as a service</summary>

Complete the following steps:

1. Specify the following command to stop the runner:

   ```language-bash
   traceable runner stop <runner_name>
   ```
2. Ensure that the Traceable runner process is currently not running:

   ```language-bash
   ps -ef | grep traceable
   ```
3. Specify the following command to remove the Traceable CLI installation:

   ```language-bash
   delete $HOME/.local/traceable directory
   ```

</details>

Enter the following command to uninstall the runner:

```language-bash
helm uninstall <deployment_name>
```

Complete the following steps:

1. Open your web browser and log in to the AWS management console.
2. In the console, navigate to the **Amazon Elastic Container** Service.
3. Click the cluster where you installed the runner.
4. Delete the runner service.
   {% endtab %}
   {% endtabs %}