License Management

Understand and manage your CODITECT licenses, seat allocations, and usage.

Understanding Licenses

Floating Concurrent Licensing

CODITECT uses a floating concurrent license model:

• Floating: Licenses aren't tied to specific machines
• Concurrent: Limits simultaneous users, not total installations
• Example: A 10-seat license allows 10 users at once, but 100 developers could have it installed

License: 10 Seats
├─ User A: Active (Seat 1)
├─ User B: Active (Seat 2)
├─ User C: Active (Seat 3)
├─ ... (7 seats available)
└─ User K: Waiting (no seat)

License Components

Component	Description
Seats	Maximum concurrent users
Product	CODITECT edition (Starter, Pro, Enterprise)
Features	Enabled capabilities
Expiration	License validity period

Viewing Licenses

Dashboard View

1. Navigate to Settings → Licenses
2. View your active licenses:

┌─────────────────────────────────────────────────────────────┐
│ License: CODI-XXXX-XXXX-XXXX                               │
├─────────────────────────────────────────────────────────────┤
│ Product:     CODITECT Pro                                   │
│ Seats:       3 / 10 active                                  │
│ Status:      Active                                         │
│ Expires:     January 9, 2027 (365 days remaining)          │
│                                                             │
│ [View Sessions] [Usage Report] [Manage]                     │
└─────────────────────────────────────────────────────────────┘

Active Sessions

Click View Sessions to see who's currently using seats:

User	Machine	Started	Last Activity
john@company.com	MacBook Pro	10:00 AM	10:25 AM
jane@company.com	Windows Desktop	9:30 AM	10:20 AM
bob@company.com	Linux Workstation	8:00 AM	10:15 AM

Managing Seats

When All Seats Are In Use

If all seats are occupied:

1. Wait: A seat may free up shortly
2. Release: Ask a colleague to close CODITECT
3. Upgrade: Purchase additional seats

Auto-Release

Sessions automatically release after 6 minutes of inactivity (no heartbeat). If someone closes their laptop, the seat will free up automatically.

Forcing Session Release

Organization admins can forcibly release sessions:

1. Go to Licenses → View Sessions
2. Select the session to terminate
3. Click Force Release
4. Confirm the action

Use Sparingly

Force releasing interrupts the user's work. Use only when necessary.

Usage Reports

Generating Reports

1. Navigate to Licenses → Usage Report
2. Select date range
3. Choose report type:
   • Summary: Overview of usage patterns
   • Detailed: Session-by-session log
   • Peak Usage: Maximum concurrent users
4. Click Generate or Export CSV

Understanding Usage Data

┌─────────────────────────────────────────────────────────────┐
│ Usage Report: January 2026                                  │
├─────────────────────────────────────────────────────────────┤
│ Peak Concurrent Users:     8 / 10 (Jan 15, 2:00 PM)        │
│ Average Daily Users:       5.2                              │
│ Total Sessions:            342                              │
│ Average Session Duration:  3.2 hours                        │
│ Seat Utilization:          52%                              │
│                                                             │
│ Recommendation: Your current plan meets your needs.         │
│ Consider upgrading if peak usage exceeds 9 seats.          │
└─────────────────────────────────────────────────────────────┘

Usage Patterns Chart

Seats
  10 │                    ▓▓▓
   8 │          ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
   6 │     ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
   4 │ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
   2 │ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
   0 └─────────────────────────────────
       6AM   9AM   12PM   3PM   6PM

Upgrading Licenses

Add More Seats

1. Go to Settings → Billing
2. Click Upgrade next to your subscription
3. Adjust seat count
4. Review prorated charges
5. Confirm upgrade

Seat additions are effective immediately.

Upgrade Plan

From	To	Benefits Added
Starter	Pro	Cloud workstations, priority support
Pro	Enterprise	SSO, audit logs, dedicated support

Volume Discounts

Seats	Discount
1-10	Standard pricing
11-25	10% off
26-50	15% off
51-100	20% off
100+	Contact sales

License Alerts

Configuring Alerts

Set up notifications for license events:

1. Go to Settings → Notifications
2. Enable license alerts:

Alert	Description
Seats exhausted	All seats are in use
License expiring	License expires within 30/7/1 days
High utilization	Peak usage exceeds 80% of seats

Alert Delivery

Alerts can be sent via:

• Email (primary contact)
• Slack integration
• Webhook to your systems

Troubleshooting

"No Seats Available"

Causes:

1. All seats genuinely in use
2. Stale sessions (user crashed without releasing)
3. VPN/network issues preventing heartbeat

Solutions:

1. Check active sessions in dashboard
2. Wait 6 minutes for stale sessions to auto-release
3. Contact admin to force release if needed

"License Expired"

Immediate steps:

1. Check if renewal payment failed (Settings → Billing)
2. Update payment method if needed
3. Contact support if auto-renewal was expected

"Invalid License Key"

Verify:

1. Copy key exactly (no extra spaces)
2. Check for typos (O vs 0, l vs 1)
3. Ensure license is for correct product

Session Keeps Disconnecting

Troubleshoot:

1. Check network stability
2. Verify firewall allows CODITECT traffic
3. Check if VPN is interfering
4. Increase heartbeat interval in settings

Best Practices

For Administrators

1. Monitor utilization - Review weekly usage reports
2. Set alerts - Know when seats are running low
3. Plan ahead - Upgrade before hitting limits
4. Clean up - Remove inactive users from organization

For Users

1. Close when done - Release seat for colleagues
2. Use one session - Don't open multiple instances
3. Check status - Verify seat acquired before starting work
4. Report issues - Tell admin if sessions behave unexpectedly

CLI Commands

# Check your license status
coditect license status

# List active sessions (admin)
coditect license sessions

# Release your session
coditect license release

# View usage report
coditect license usage --period 30d