Removing the Agent
Removing the MyOsicam agent from a server is a two-step process: uninstall the agent on the server (stop the service, remove the binary and its supporting files), then delete the agent record from the panel. OScam is not affected by either step — it continues running exactly as it did before you installed the agent.
Step 1 — Uninstall the agent on the server
The uninstall sequence stops the myosicam-agent systemd service, removes the binary and service
unit, clears the sudoers rule, and deletes the agent’s working directory at /opt/oscam-agent
(which holds registration state and the shared HMAC secret). OScam is not affected at any point.
For the complete copy-runnable command block, see:
Troubleshooting / FAQ → Can I uninstall the agent cleanly?
Step 2 — Delete the agent record from the panel
Once the agent is no longer running on the server, remove its record from the panel:
- Log in to the panel.
- In the left sidebar, click Agents.
- Find the agent row for the server you just uninstalled from (it should now show Offline).
- Click Delete Agent in the Actions column.
- Confirm the deletion.
Deleting the agent record removes:
- The agent’s registration entry and token.
- Any discovered OScam instance records for that agent.
- The agent’s heartbeat and last-seen history.
What happens to OScam
After removing the agent:
- OScam on the server continues running exactly as it was before the agent was installed.
- The
oscam.conf,oscam.server, andoscam.userfiles are untouched. - Your subscribers continue to be served without interruption.
The only changes to the server are the removal of:
- The
myosicam-agentsystemd service unit. - The
/usr/local/bin/myosicam-agentbinary. - The
/etc/sudoers.d/myosicam-agentsudoers rule. - The
/opt/oscam-agentworking directory.
Removing an agent that is already offline
If the server is no longer accessible (e.g., the VPS has been deprovisioned), you cannot run the uninstall commands. In this case, skip Step 1 and proceed directly to Step 2 — delete the agent record from the panel. Since the server no longer exists, there is nothing left to clean up on it.
Related pages
- Troubleshooting / FAQ — canonical uninstall command block.
- Upgrading the Agent — upgrade instead of removing.
- Removing an OScam Install — deregister an OScam install from the panel.
- Install the Agent — re-install an agent after removal.