AirCast

Prerequisites

Before uninstalling AirCast, make sure you have the following:

  • SSH access to your Raspberry Pi
  • sudo privileges on your system
  • A stable connection to your device

If you need help connecting to your Raspberry Pi via SSH, refer to our SSH guide before proceeding with the uninstallation process.

SSH Access Guide →

Connect to your Raspberry Pi via SSH

Quick Uninstallation

For a faster uninstallation, use our one-line command that handles the entire removal process automatically:

curl -sSL https://aircast.one/uninstall.sh | sudo bash

Note

This script automates the complete removal of AirCast Agent, including all configuration files, repositories, and GPG keys.

Manual Uninstallation

Stop and Disable the AirCast Service

First, stop the active AirCast service to prevent any ongoing operations:

sudo systemctl stop aircast-agent

Then, disable the service so it doesn't start automatically on system boot:

sudo systemctl disable aircast-agent

Remove the AirCast Package

Completely remove the AirCast Agent package and its configuration files:

sudo apt-get purge aircast-agent

Remove any dependencies that were automatically installed and are no longer needed:

sudo apt-get autoremove

Remove the Repository Configuration

Delete the AirCast repository from your APT sources:

sudo rm /etc/apt/sources.list.d/aircast-agent.list

Remove the GPG Key

Delete the AirCast GPG key used for package verification:

sudo rm /usr/share/keyrings/aircast.gpg

Remove DNS Configuration

If you want to revert any DNS changes made during installation:

sudo rm /etc/NetworkManager/conf.d/dns.conf

Update Package Lists

Finally, update your package lists to reflect the changes:

sudo apt-get update

Verification

To verify that AirCast Agent has been completely removed from your system, you can run:

dpkg -l | grep aircast

If no results are returned, the uninstallation was successful.

Troubleshooting

If you encounter any issues during the uninstallation process:

Service Not Stopping

If the service won't stop normally, try forcing it:

sudo killall aircast-agent

Package Not Removing

If apt-get purge doesn't work, try forcing removal with dpkg:

sudo dpkg --remove --force-all aircast-agent

Files Remaining

Check for leftover files and remove them manually:

sudo rm -rf /etc/aircast/ /var/lib/aircast/

Next Steps

After uninstalling AirCast Agent, you might want to:

  • Reboot your Raspberry Pi to ensure all changes take effect
  • Check your system resources to confirm memory and CPU usage has decreased
  • Verify network configurations if you made any changes for AirCast

If you changed your mind and want to reinstall AirCast Agent in the future, you can follow our installation guide:

AirCast Installation Guide →

Install and set up AirCast Agent on your Raspberry Pi