Managing OScam Users

The OSCam Users section of the MyOsicam panel lets you create and manage OScam subscriber accounts across all your registered installs. When you save a change, the panel writes it directly to the oscam.user file on the relevant server and triggers a live WebIF reload — no OScam restart is needed and no active sessions are interrupted.

Note

This page covers panel-based user management (the OSCam Users sidebar section). It applies to the older panel architecture where OScam installs are registered directly on the panel host. If you are managing installs through the Go agent, the agent applies the same changes but routes them through its own sync mechanism.

Open the user list

1. Log in to the panel.
2. In the left sidebar, click OSCam Users.
3. The user table shows every OScam user across all your registered installs, with columns for Install, User, Password, Subscription (plan name), Status, Manual Access, Expires, and Actions.

Tip

Use the install filter in the URL (?install_id=<n>) to narrow the list to a single OScam install when you manage many installs from one panel.

Add a user

1. Click Create your first user (if the list is empty) or the Create User button.

2. The Create OSCam User modal opens.

3. Fill in the fields:

   Field	Required	Notes
   OSCam installs	Yes	Tick one or more installs this user will be written to.
   Username	Yes	3–32 characters; letters, digits, underscores, or hyphens only (^[a-zA-Z0-9_-]{3,32}$).
   Password	Yes	Up to 128 characters; stored in oscam.user in plain text as required by OScam.
   Plan	No	Select a subscription plan to set an automatic expiry. Leave blank for an unlimited lifetime user.
   Custom end date	No	Override the plan expiry with a specific date (YYYY-MM-DD).

4. Click Create User.

Caution

The username must be unique per install. If the same username already exists on a selected install, the create will fail with a validation error and no file will be written.

What happens on create

The panel:

1. Validates the username and password.
2. Writes panel_users/{username}.conf on each selected install using an atomic write-then-rename so OScam never reads a half-written file.
3. Inserts a corresponding database record.
4. Triggers a live WebIF reload so OScam picks up the new user without a restart.

If any step fails, the panel rolls back the file write — no partial state is left on disk.

Edit a user

1. In the user table, find the row you want and click Edit in the Actions column.
2. The Edit modal opens, pre-filled with the current values.
3. Update the fields as needed. If you leave Password blank, the existing password is kept unchanged — you cannot read the current password back, only replace it.
4. Click Save (or the equivalent submit button in the modal).

View a user’s details

Click View in the Actions column to open a read-only details modal showing the user’s current configuration, linked installs, subscription status, and expiry date.

Disable and enable a user manually

The Manual Access column shows whether a user has been manually disabled, independently of their subscription status.

• If the user is currently active, the Actions column shows a Disable button.
• If the user is already manually disabled, the Actions column shows an Enable button.

Click the appropriate button and confirm the action. Manually disabling a user sets disabled = 1 in their oscam.user entry and triggers a live reload. Enabling reverses this.

Note

A manually disabled user is distinct from a subscription-expired user. A user whose subscription has expired is automatically marked disabled = 1 at the next sync; a manually disabled user retains their subscription record but is blocked regardless of its status.

Delete a user

1. Click Delete in the Actions column.

2. A confirmation dialog appears.

   Caution

   If the user has an active subscription the dialog shows a warning before you can confirm. Deleting a subscriber removes their access immediately.

3. Confirm the deletion. The panel removes the database record, the panel_users/{username}.conf file, and (via cascade) the subscription record.

User status labels

The Status column shows a colour-coded badge based on the user’s subscription state:

Badge	Meaning
Active	Subscription is active and not expired. disabled = 0 in oscam.user.
Expired	Subscription expiry date has passed. disabled = 1 in oscam.user.
Other states	Suspended, no subscription, or a custom state defined by your plan.

What is written to oscam.user

Each user is represented by a single [account] section in the panel_users/{username}.conf file. The format the panel writes is:

panel_users/alice.conf

[account]
user                          = alice
pwd                           = s3cr3t
disabled                      = 0
expdate                       = 2026-12-31
monlevel                      = 0

Field	Source	Notes
user	Username	Must match the filename stem exactly.
pwd	Password you set	Stored plain text — this is an OScam requirement.
disabled	Subscription/manual state	0 = active; 1 = expired or manually disabled.
expdate	Plan or custom end date	YYYY-MM-DD; empty if no expiry is set.
monlevel	System constant	Always 0 — users cannot access the OScam monitor.

Note

The panel never modifies oscam.conf or oscam.server. All writes are confined to the panel_users/ directory for each install.

Next steps

• Managing WebIF Credentials — store the credentials used to reach each OScam server’s built-in web interface.
• Install Groups — organise your installs into logical groups.
• Fleet View — see status across all installs at a glance.