License Issues

Solutions to license activation and tier-related problems.

License Tiers

Available Tiers

Tier	Server Limit	Features
Free	1 server	Basic monitoring, whitelist sync
Personal	3 servers	+ AbuseIPDB, custom templates
Pro	25 servers	+ SIEM, terminal, port knocking
Enterprise	Unlimited	+ Priority support, SLA

Check Current License

curl "https://bloqd.example.com/api/v1/settings/license" \
  -H "Authorization: Bearer f2b_your_api_key"

Response:

{
  "tier": "personal",
  "server_limit": 3,
  "servers_used": 2,
  "expires_at": null,
  "registered_to": "user@example.com"
}

Activation Issues

License Key Invalid

Symptom: "Invalid license key" error.

Solutions:

1. Check key format:

   Valid format: BLOQD-XXXX-XXXX-XXXX

2. Remove spaces/dashes:

   • Copy the key exactly as received
   • Don't add or remove characters

3. Check email for correct key:

   • Search for emails from Bloqd
   • Check spam/junk folder

4. Contact support if key was purchased but not received

Activation Failed

Symptom: License activation request fails.

Solutions:

1. Check internet connectivity:

   # Container needs outbound HTTPS
   docker compose exec bloqd curl https://license.bloqd.io/verify

2. Check firewall rules:

   # Allow outbound to license server
   # license.bloqd.io:443

3. Verify server time:

   docker compose exec bloqd date

4. Try offline activation (if available):

   • Contact support for offline activation code

License Already Used

Symptom: "License key already activated on another installation."

Solutions:

1. Deactivate old installation:

   • Log into previous installation
   • Go to Settings → License → Deactivate

2. Contact support for license transfer

3. For development - Each environment needs separate license

Server Limit Issues

Server Limit Reached

Symptom: Cannot add more servers.

Solutions:

1. Check current usage:

   curl "https://bloqd.example.com/api/v1/servers" \
     -H "Authorization: Bearer f2b_your_api_key" | jq '.total'

2. Remove unused servers:

   • Dashboard → Servers → Delete offline/unused servers

3. Upgrade license:

   • Personal (3) → Pro (25) → Enterprise (unlimited)

4. Check for duplicate servers:

   curl "https://bloqd.example.com/api/v1/servers" \
     -H "Authorization: Bearer f2b_your_api_key" | \
     jq '.servers[] | {id, hostname, status}'

Wrong Server Count

Symptom: Server count doesn't match actual servers.

Solutions:

1. List all servers:

   curl "https://bloqd.example.com/api/v1/servers" \
     -H "Authorization: Bearer f2b_your_api_key"

2. Check for pending servers:

   • Pending servers count toward limit
   • Either complete setup or delete them

3. Remove deleted servers:

   • If servers were removed from dashboard but still counted
   • Contact support for database cleanup

Feature Restrictions

Feature Not Available

Symptom: Feature says "Pro required" or similar.

Common restricted features:

Feature	Required Tier
Basic monitoring	Free
1+ servers	Personal
AbuseIPDB integration	Personal
Custom templates	Personal
SIEM integration	Pro
Web terminal	Pro
Port knocking	Pro
API rate limit increase	Pro

Solutions:

1. Verify current tier:

   • Settings → License

2. Upgrade license if needed

3. Check if feature is enabled:

   curl "https://bloqd.example.com/api/v1/settings/license" \
     -H "Authorization: Bearer f2b_your_api_key" | jq '.features'

Features Not Working After Upgrade

Symptom: Paid for upgrade but features still restricted.

Solutions:

1. Refresh license:

   curl -X POST "https://bloqd.example.com/api/v1/settings/license/refresh" \
     -H "Authorization: Bearer f2b_your_api_key"

2. Clear browser cache and re-login

3. Restart Bloqd:

   docker compose restart bloqd

4. Re-enter license key if needed

Expiration Issues

License Expired

Symptom: Features stop working, "license expired" message.

Solutions:

1. Check expiration:

   curl "https://bloqd.example.com/api/v1/settings/license" \
     -H "Authorization: Bearer f2b_your_api_key" | jq '.expires_at'

2. Renew license:

   • Purchase renewal from Bloqd website
   • Enter new license key

3. Grace period:

   • Licenses typically have a 7-day grace period
   • Core functionality continues working

Subscription Renewal

For subscription-based licenses:

1. Update payment method on your account
2. Check for failed payments in billing history
3. Manual renewal if auto-renewal failed

Offline Installations

Air-Gapped Environments

For installations without internet access:

1. Request offline license:

   • Contact support with your installation ID
   • Provide server hardware fingerprint

2. Installation ID:

   docker compose exec bloqd cat /app/data/.installation_id

3. Apply offline license:

   curl -X POST "https://bloqd.example.com/api/v1/settings/license" \
     -H "Authorization: Bearer f2b_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{"license_key": "BLOQD-OFFLINE-XXX", "offline": true}'

Development/Testing

Development Licenses

For development and testing:

1. Free tier allows 1 server for testing
2. Request development license from support
3. Use separate license for each environment

Staging Environments

• Production and staging need separate licenses
• Contact support for staging discounts

Billing Issues

Payment Failed

Solutions:

1. Update payment method in account settings
2. Check for card issues (expired, insufficient funds)
3. Try alternative payment (different card, PayPal)
4. Contact support for invoice payment

Refunds

• Refunds available within 14 days of purchase
• Contact support with order number
• Prorated refunds for annual subscriptions

Getting Help

For license issues not covered here:

1. Email: support@bloqd.io
2. Include:
   • License key (first 8 characters only)
   • Installation ID
   • Error message
   • Screenshot if applicable

Security

Never share your full license key publicly. Only share the first 8 characters when requesting support.