User Roles and Permissions

BugPin uses three user roles to control access: Admin, Editor, and Viewer. This page covers the permissions each role carries, how to create and manage users in the Admin Console, and best practices for team access.

Overview

BugPin supports three user roles with different permission levels:

Role	Description
Admin	Full system access
Editor	Can edit reports and manage personal settings
Viewer	Read-only access to reports

Role Details

Admin

Administrators have complete control over the BugPin instance.

Permissions:

• View, create, edit, and delete reports
• Forward reports to integrations (GitHub, etc.)
• Manage projects (create, update, delete, regenerate API keys)
• Manage users (create, update, delete, assign roles)
• Configure integrations (GitHub)
• Access and modify system settings (SMTP, retention, branding)
• Manage notification preferences
• Edit own profile and avatar

Best for: System administrators, team leads, DevOps engineers

Editor

Editors can manage bug reports but cannot access system configuration.

Permissions:

• View and edit reports (status, priority, assignments)
• Bulk update reports
• Manage own notification preferences
• Edit own profile and avatar

Cannot:

• Delete reports
• Forward reports to integrations
• Access projects, users, integrations, or settings

Best for: Developers, QA team members, project managers

Viewer

Viewers have read-only access to reports.

Permissions:

• View reports and report details
• View dashboard and statistics
• Manage own notification preferences
• Edit own profile and avatar

Cannot:

• Edit or delete reports
• Forward reports to integrations
• Access projects, users, integrations, or settings

Best for: Stakeholders, customer support, external contractors

Permissions Matrix

Feature	Admin	Editor	Viewer
Reports
View reports	Yes	Yes	Yes
Edit reports	Yes	Yes	No
Delete reports	Yes	No	No
Forward to integrations	Yes	No	No
Administration
Manage projects	Yes	No	No
Manage users	Yes	No	No
Configure integrations	Yes	No	No
System settings	Yes	No	No
Personal
Edit own profile	Yes	Yes	Yes
Manage notifications	Yes	Yes	Yes

Managing Users

Creating Users

1. Navigate to Settings > Users (admin only)
2. Click Add User
3. Fill in:
   • Name
   • Email
   • Password (minimum 8 characters)
   • Role
4. Click Create

Changing Roles

1. Go to Settings > Users
2. Find the user in the list
3. Select the new role from the dropdown
4. Changes are saved immediately

note

Users cannot change their own role to prevent privilege escalation.

Default Admin Account

On first startup, BugPin creates a default admin account:

• Email: admin@example.com
• Password: changeme123

warning

Change the default password immediately after first login.

Best Practices

Role Assignment

1. Start with Viewer - Assign the minimum required role initially
2. Promote as needed - Give Editor access to those who triage bugs
3. Limit Admins - Reserve Admin for trusted system administrators

Security

1. Admin accounts - Use strong passwords, limit the number of admins
2. Regular audits - Review user roles periodically, remove inactive users
3. Viewer for external access - Safe for stakeholders with no modification risk