Skip to content

User Credential Management

Overview

Use vjbctl to manage user credentials: list users, delete users, change passwords, and refresh credentials.

Assumptions

Before you start, ensure the following prerequisites are fulfilled:

  • vJailbreak is installed and configured properly.

Command Reference

The following commands are available for user credential management:

Terminal window
# List users
vjbctl user list
# create a new user
vjbctl user create <username>
# Delete a user
vjbctl user delete <username>
# Change a user's password
vjbctl user change-password <username>
# Refresh user credentials
vjbctl user refresh

Tip: Append --no-restart to vjbctl user subcommands (e.g., create, delete, change-password) to defer applying changes. Then run vjbctl user refresh once to apply all pending changes for better efficiency.

Usage

Note: After any user change (e.g., password updates or deletions), run vjbctl user refresh for the changes to be reflected.

List users

Terminal window
vjbctl user list

Delete a user

Delete a user and remove their credentials from the system:

Terminal window
vjbctl user delete <username>

Change a user’s password

Change the password for an existing user:

Terminal window
vjbctl user change-password <username>

You will be prompted to enter the new password in the terminal.

Batch multiple changes efficiently

To avoid refreshing after every change, you can batch multiple operations using --no-restart and then apply them all at once with a single refresh:

Terminal window
# Defer applying changes while making multiple updates
vjbctl user create <username> --no-restart
vjbctl user change-password <username> --no-restart
vjbctl user delete <username> --no-restart
# Apply all pending changes
vjbctl user refresh

Refresh user credentials

Refresh user credentials for active users:

Terminal window
vjbctl user refresh

Examples

The following sequence demonstrates a typical workflow for updating user credentials:

Terminal window
# Inspect existing users
vjbctl user list
# Create a new user
vjbctl user create john.doe
# For changes to be reflected, refresh
vjbctl user refresh
# Update password for a specific user
vjbctl user change-password jane.doe
# For changes to be reflected, refresh
vjbctl user refresh
# Remove a deprovisioned user
vjbctl user delete temp.user
# For changes to be reflected, refresh
vjbctl user refresh