Removing an OScam Install
Removing an OScam install from the MyOsicam panel deletes its registry entry — the record
the panel uses to track, monitor, and manage that install. It does not touch any files on
the OScam server: the OScam binary, configuration files (oscam.conf, oscam.server,
oscam.user), and any running OScam process are completely unaffected.
When to remove an install
Common reasons to remove an install from the panel:
- You are decommissioning the OScam server (or the VPS it runs on).
- You are reorganising your fleet and want to re-register the install under a different agent.
- You want to free an install slot on your license.
- The install is stale (e.g., the server no longer exists).
Before you remove
1. Check for linked OScam users
If the install has OScam users linked to it, the panel will block deletion until those users are removed or reassigned. The delete confirmation dialog shows the number of linked users:
To free the install, first go to OSCam Users in the sidebar and either:
- Delete each user linked to this install, or
- Edit each user and move them to a different install.
2. Confirm OScam is not managed exclusively through this install record
If you use the panel to apply configuration changes or user account changes to this OScam server, those operations will stop working once the install record is removed. Make sure you have an alternative management path (e.g., direct SSH access to the server) before removing.
Removing the install
- Log in to the panel.
- In the left sidebar, click OSCam Installs.
- Find the install you want to remove in the table.
- In the Actions column, click the delete button (trash icon).
- A confirmation dialog appears. If there are linked users, resolve them first (see above).
- If the install has no linked users, the dialog shows the message: “This action removes the install registry entry only. OSCam runtime files are not modified.”
- Click Confirm Delete.
The panel removes the install’s database record and returns a success message.
What is removed
When you delete an install record, the panel removes:
- The install’s entry in the panel database (name, config path, agent link, health status, etc.).
- All resource readings associated with that install (
resource_readingsrows). - Any install group membership entries for that install.
What is NOT removed
- OScam itself — the OScam binary,
oscam.conf,oscam.server,oscam.user, and any running OScam process on the server are completely untouched. - The agent — if a Go agent is running on the server, it continues running. Its registration record stays in the panel. Only the install record for this specific OScam instance is removed.
- Other installs on the same server — if other OScam installs were registered from the same server, those records are not affected.
After removal
- The install no longer appears in the OSCam Installs list.
- The freed install slot is reflected in your license quota.
- If you want to re-register the same OScam instance later, use Register Install from the OSCam Installs page and provide the same path details.
Decommissioning the server entirely
If you are decommissioning the entire OScam server (not just a single install):
- Remove all OScam install records for that server from the panel (this page).
- Remove the agent record from the panel — see Removing the Agent.
- Uninstall the agent from the server before deprovisioning — see Removing the Agent.
Related pages
- Managing OScam Users — remove or reassign users before deleting an install.
- Removing the Agent — deregister and uninstall the agent.
- Operational Monitoring — understand install health status before removing.