Managing Users
As an administrator, you can create, edit, and manage user accounts in PteroCA. This guide covers all user management functions.
Accessing User Management
To manage users:
Click Users in the admin sidebar
You'll see a list of all registered users
Required permission: access_users or admin role
User List
User List View
The user list displays:
Email - User's email address (unique identifier)
Name - First and last name (if provided)
Balance - Current wallet balance
Verified - Email verification status
Blocked - Whether account is blocked
Roles - Assigned roles (admin, user, custom)
Created - Registration date
Actions - Edit, delete, view servers
Filtering and Search
Search for users:
By email address
By name
By ID
Filter users:
Verified vs. unverified
Blocked vs. active
By role
By registration date
Creating New Users
How to Create a User
Click Create User or Add New button
Fill in the required information
Configure options
Save to create account
Required Fields
Email Address
Requirements:
Valid email format
Unique (not already registered)
Will be used for login and notifications
Email Uniqueness
Each email can only be used once. If you try to create a user with an existing email, you'll get an error.
Password
When creating a user:
Set initial password
User can change it later
Must meet password requirements
Password requirements:
Minimum length (typically 8-12 characters)
May require uppercase, lowercase, numbers, symbols
Security tip: Generate strong random passwords for new accounts.
Optional Fields
First Name and Last Name
User's full name
Helps identify users in support tickets
Used in email communications
Avatar
Upload profile picture for user
Will display in dashboard and Pterodactyl Panel
Accepts JPG, PNG, GIF
User Configuration
Balance
Starting balance:
Set initial wallet balance
Can be $0 or any amount
Useful for promotional credits or compensations
Use cases:
Give new users free credits
Compensate for service issues
Manual payment crediting
Roles
Assign user roles:
user - Default role (client access)
admin - Full administrative access
Custom roles - Your defined roles with specific permissions
Multiple roles:
Users can have multiple roles
Permissions are combined
More permissive permission wins
See Roles & Permissions for details.
Email Verification Status
isVerified checkbox:
Checked - Mark email as verified
Unchecked - Email needs verification
When to manually verify:
Technical issues preventing auto-verification
Migrating users from another system
Compensating for email delivery problems
VIP/known customers
Account Block Status
isBlocked checkbox:
Checked - Account is blocked (cannot log in)
Unchecked - Account is active
When to block accounts:
Fraudulent activity
Terms of Service violations
Payment disputes
Abuse or spam
Account security issues
Pterodactyl Synchronization
Automatic sync:
Creating a user in PteroCA automatically creates a Pterodactyl account
Email, name, and password are synchronized
Avatar is synced
User can log into Pterodactyl with same credentials
SSO integration:
Users can access Pterodactyl from PteroCA without re-entering password
Password changes sync automatically
Editing Users
How to Edit a User
Find the user in the user list
Click Edit action
Modify fields
Save changes
Editable Fields
Most user fields can be edited:
Email (disabled in some cases for security)
First and last name
Avatar
Balance - Add or deduct funds
Roles - Change assigned roles
isVerified - Toggle verification status
isBlocked - Block or unblock account
Password - Reset user's password
Modifying Balance
Adjusting user balance:
Edit user
Find Balance field
Enter new balance amount
Save changes
Use cases:
Add promotional credits
Refund for service issues
Correct billing errors
Manual payment processing
Transaction Logging
Balance changes are logged in system logs. Always include a reason when manually adjusting balances for audit trail.
Changing User Roles
To modify roles:
Edit user
Find Roles field
Select/deselect roles
Save changes
Common scenarios:
Promote user to admin
Create support staff role
Demote admin to user
Assign custom role
Effects:
New permissions take effect immediately
User may need to log out/in to see menu changes
Access is checked on every page load
Resetting Passwords
As administrator:
Edit user
Find Password field
Enter new password
Confirm new password
Save changes
What happens:
User's password is changed immediately
User is NOT notified automatically (unless you enable notifications)
Password syncs to Pterodactyl
User can log in with new password
Password Reset Communication
If you reset a user's password, contact them separately (email, ticket, etc.) to provide the new password. The system doesn't send automatic notification.
Verifying Email Manually
If user can't verify email:
Edit user
Check isVerified checkbox
Save changes
User can now purchase servers (if verification was required)
When to use:
Email delivery issues
Known legitimate user
Migration from old system
Corporate/institutional emails blocking verification emails
Deleting Users
Soft Delete
PteroCA uses soft delete for user accounts:
User is marked as deleted but not removed from database
Can be restored if needed
Maintains data integrity
How to Delete a User
Find user in list
Click Delete action
Confirm deletion
Deletion Restrictions
Cannot delete user if:
User has active servers
User has pending payments
Why?
Prevents orphaned servers
Maintains payment records
Ensures data consistency
To delete user with servers:
Delete or transfer all user's servers first
Then delete user account
Restoring Deleted Users
If soft delete is implemented:
Access deleted users list (if available)
Find deleted user
Click Restore
User account is reactivated
Viewing User Servers
To see a user's servers:
Click on user in user list
View Servers tab or section
List of all servers owned by that user
What you can see:
Server names
Server status (active, suspended)
Server expiration dates
Product information
Quick actions:
Jump to server management
Suspend/unsuspend server
View server details
User Activity Logs
Track user actions:
Login history
Server purchases
Server renewals
Balance changes
Configuration changes
How to view:
Navigate to Logs → System Logs
Filter by user email or ID
View all actions taken by that user
See Logs & Monitoring for details.
Bulk Operations
Depending on your PteroCA configuration, you may be able to:
Bulk Actions
Delete multiple users
Block multiple users
Change roles for multiple users
Export user list
How to use:
Select users using checkboxes
Choose bulk action from dropdown
Confirm action
Operation applies to all selected users
User Notifications
Email Notifications
Users receive emails for:
Account created - Welcome email with login details
Password changed - Security notification
Balance added - Payment confirmation
Server purchased - Purchase confirmation
Server expiring - Renewal reminders
Server suspended - Suspension notification
Admin-Triggered Emails
As admin, you can trigger:
Password reset emails (if feature enabled)
Custom notifications (if configured)
Verification email resend
Security and Privacy
Viewing User Data
What you can access:
Email, name, profile
Balance and payment history
Server list
Activity logs
Login history
What you CANNOT see:
Plain-text passwords (only hashed)
Credit card details (handled by payment gateways)
Data Protection
Best practices:
Only access user data when necessary
Don't share user information
Respect privacy
Follow data protection regulations (GDPR, etc.)
Account Security
Protecting user accounts:
Enforce strong passwords
Enable email verification
Monitor for suspicious activity
Block compromised accounts
Audit admin actions
Troubleshooting
User Can't Log In
Possible causes:
Wrong email or password
Account blocked
Email not verified (if required)
Account deleted
Solutions:
Check if account is blocked (unblock if appropriate)
Verify email verification status
Reset password if forgotten
Check if account was deleted
User Not Showing in List
Possible causes:
Recently created (page not refreshed)
Filters applied
Account deleted
Search criteria too specific
Solutions:
Refresh page
Clear all filters
Check deleted users list
Broaden search criteria
Cannot Delete User
Error: "User has active servers"
Solution:
View user's server list
Delete or transfer all servers
Try deleting user again
Error: "User has pending payments"
Solution:
Resolve or cancel pending payments
Try deleting user again
Balance Not Updating
If manual balance change doesn't save:
Check for validation errors
Ensure amount is valid number
Verify permission to edit users
Check system logs for errors
Contact support if persistent
Role Changes Not Taking Effect
If permission changes don't work:
Verify role was saved
Ask user to log out and log in again
Clear browser cache
Check role has correct permissions assigned
Best Practices
User Management
Do:
Verify identities before making sensitive changes
Document reason for manual balance adjustments
Use custom roles for specialized access
Regularly audit user permissions
Monitor for inactive accounts
Communicate password resets to users
Don't:
Share admin credentials
Give admin access unnecessarily
Delete users without backing up data
Modify balances without reason
Ignore suspicious activity
Security Practices
Review user activity logs regularly
Block suspicious accounts immediately
Verify email before manually setting verified status
Use strong passwords when creating accounts
Enable email verification by default
Audit admin actions monthly
Communication
Inform users of account changes
Provide clear instructions for password resets
Respond to verification issues promptly
Set expectations for support response times
Related Guides
Managing Servers - Server administration
Payments & Orders - User payment history
Logs & Monitoring - User activity tracking
Access Control - Roles and permissions
Vouchers - Promotional codes for users
Need Help?
For user management questions:
Check FAQ
Review Troubleshooting Guide
Join Discord Community
Contact technical support
Last updated