Users

Users are the people who interact with OpsKnight — from responders handling incidents to administrators managing the platform. This guide covers user management, roles, permissions, and personal settings.

Why User Management Matters

Without Proper User Management	With Proper User Management
Everyone has full access	Role-based access control
No accountability	Clear audit trail
Alert fatigue for all	Targeted notifications
Manual onboarding	Streamlined invite flow

User Roles

OpsKnight has three user roles with different permission levels:

Role	Description	Best For
ADMIN	Full platform access	Platform administrators, team leads
RESPONDER	Incident handling capabilities	On-call engineers, SREs
USER	Read-only access	Stakeholders, managers

Role Permissions Matrix

Permission	Admin	Responder	User
View Dashboard	✅	✅	✅
View Incidents	✅	✅	✅
View Services	✅	✅	✅
Acknowledge Incidents	✅	✅	❌
Resolve Incidents	✅	✅	❌
Reassign Incidents	✅	✅	❌
Add Notes to Incidents	✅	✅	❌
Create Incidents	✅	✅	❌
Manage Schedules	✅	✅	❌
Create Overrides	✅	✅	❌
Create Services	✅	❌	❌
Edit Services	✅	❌	❌
Delete Services	✅	❌	❌
Manage Teams	✅	❌	❌
Manage Escalation Policies	✅	❌	❌
Manage Integrations	✅	❌	❌
Invite Users	✅	❌	❌
Manage User Roles	✅	❌	❌
System Settings	✅	❌	❌
View Analytics	✅	✅	✅
Export Data	✅	✅	❌

User Statuses

Users move through different statuses in their lifecycle:

Status	Description	Can Login
INVITED	Invitation sent, pending acceptance	❌
ACTIVE	Account active and functional	✅
DISABLED	Account deactivated	❌

Status Flow

INVITED ──(accept invite)──► ACTIVE ──(deactivate)──► DISABLED
                                ▲                         │
                                └────(reactivate)─────────┘

Adding Users

First Admin Account (Initial Setup)

When OpsKnight starts with no users:

Navigate to /setup in your browser
Enter admin details:
- Email: Your email address
- Name: Your display name
Click Create Admin
Save the generated password immediately — it's shown only once
Log in with your credentials

Important: The /setup page is only accessible when no users exist in the system.

Inviting Users (Standard Method)

The recommended way to add users:

Go to Settings → Users
Click Invite User
Fill in the invitation form:

Field	Required	Description
Email	Yes	User's email address
Name	Yes	Display name
Role	Yes	ADMIN, RESPONDER, or USER

Click Send Invitation

Invitation Process

Invitation sent — User receives email with invite link
Link expires — Invitations valid for 7 days
User accepts — Clicks link, sets password
Account active — User can log in immediately

Resending Invitations

If an invitation expires or user didn't receive it:

Find user in the Users list (status: INVITED)
Click the user row
Click Resend Invitation
New invitation email sent

User Profile

Each user has a profile with personal information and preferences.

Profile Fields

Field	Description	Editable By
Email	Login identifier	Admin only
Name	Display name	User, Admin
Phone	Phone number for SMS	User, Admin
Timezone	User's local timezone	User, Admin
Avatar	Profile picture (Gravatar)	Automatic
Role	Permission level	Admin only
Status	Account status	Admin only