License Management

Managing your Journiv Plus license is straightforward. This guide covers everything you need to know about viewing license information, refreshing status, resetting your license, and handling expiration.

Viewing License Information

Accessing License Settings

To view your license information:

1. Log In - Sign in as an administrator
2. Go to Settings - Navigate to Settings → Journiv Plus
3. View Details - Your license information is displayed on the license screen

Understanding License Status

Active - Your license is valid and Plus features are available

Expired - Your subscription has expired. Renew to continue using Plus features

Invalid - Your license is not valid. This can happen if:

• The license was revoked for abuse, sharing with other instances or other reasons.
• Contact support if you believe your license was revoked incorrectly

Refreshing License Status

When to Refresh

Refresh your license status when:

• You've renewed your subscription
• You want to check for the latest license information
• You suspect your license status might be outdated
• You've made changes to your subscription

How to Refresh

1. Open License Settings - Go to Settings → Journiv Plus
2. Click Refresh - Click the "Refresh Status" button
3. Wait for Update - The system will fetch the latest information from the license server
4. View Updated Info - Your license information will update automatically

Refresh Behavior

• Network Required - Refreshing requires internet connectivity
• Rate Limited - You can refresh license status only a few times per day.
• Cached Data - If refresh fails, cached license information is shown
• Automatic Updates - License status is also refreshed automatically in the background approximately every 6 hours.

Resetting Your License

When to Reset

You may need to reset (unbind) your license when:

• Migrating to a New Server - Moving your Journiv instance to a new machine
• Hardware Changes - Significant hardware changes that affect your install ID
• Reinstalling - Performing a fresh installation of Journiv
• Transferring License - Moving your license to a different installation

How to Reset

1. Open License Settings - Navigate to Settings → Journiv Plus
2. Click Reset License - Click the "Reset License" action
3. Confirm Email - Enter your registered email address for verification
4. Confirm Reset - Confirm that you want to unbind the license

Reset Process

When you reset your license:

1. Local Cleanup - Your local license state is cleared immediately
2. Server Unbinding - The license server is notified to unbind your install ID
3. License Freed - Your license becomes available for registration on another installation
4. Features Disabled - Plus features stop working until you register again

Reset Requirements

• Admin Access - Only administrators can reset licenses
• Email Verification - You must enter the correct registered email associated with the license
• Rate Limits - You can reset/register up to 3 times per month per license.
• Internet Connection - Reset requires connectivity to the license server

After Resetting

After resetting your license:

• Register Again - You can register the same license on a new installation
• Same License Key - Use the same license key you used before
• No Data Loss - Your journal entries and all data are unaffected
• Features Disabled - Plus features won't work until you register again

License Expiration

Subscription Licenses

If you have a subscription license:

• Expiration Date - Your license expires on a specific date
• Renewal - Renew your subscription before expiration to continue using Plus features
• Grace Period - Plus features may continue working briefly after expiration
• Automatic Disable - Plus features will stop working after expiration.

Handling Expiration

Before Expiration:

• Monitor your expiration date in the license settings
• Renew your subscription before it expires
• Set reminders for renewal dates

After Expiration:

• Renew your subscription to reactivate Plus features
• Your license key remains the same
• Simply renew and refresh your license status

License Binding and Hardware Changes

How Binding Works

Your license is bound to your installation's unique identifier (install ID). This identifier is based on your hardware and system configuration. It is not derived from your IP address, domain name or any other personal information.

When Binding Changes

Your install ID may change if:

• You replace major hardware components
• You migrate to a completely different server
• You perform a fresh OS installation
• You change virtualization platforms

Handling Hardware Changes

Minor Changes - Small hardware changes usually don't affect your install ID. Your license should continue working.

Major Changes - Significant hardware changes may change your install ID. If Plus features stop working:

1. Check License Status - Verify your license is still active
2. Try Refreshing - Refresh your license status first
3. Reset if Needed - If refresh doesn't work, reset and re-register your license
4. Contact Support - If issues persist, contact support for assistance

Rate Limits

License Management Limits

• 4 license management operations per day - You can register or reset the same license up to 4 times per 24 hours
• Per license - Limits apply per license key
• Per install ID - Limits also consider your installation ID

Validation Limits

• 6 license use operation per day - License refresh, information and validation checks are rate limited to 6 times per day per license.
• Per license - Limits apply per license key
• Per installation - Limits apply per install ID

Why Rate Limits Exist

Rate limits protect:

• License Security - Prevent abuse, sharing and unauthorized access attempts
• Server Resources - Ensure fair use of license server resources
• System Stability - Maintain reliable service for all users

If you hit a rate limit:

• Wait for the specified time period
• Try again after the limit expires
• Contact support if you need immediate assistance

Troubleshooting License Issues

License Not Working

Check License Status:

1. Go to Settings → Journiv Plus
2. Verify your license shows as "Active"
3. Check for any error messages

Common Causes:

• License expired (renew your subscription)
• License invalid (contact support)
• Version incompatibility (update Journiv)
• Network issues (check connectivity)

"License Required" Errors

If you see "Journiv Plus license required" messages:

1. Verify Registration - Check that your license is registered
2. Check Status - Ensure your license is active
3. Refresh Status - Try refreshing your license information
4. Re-register - If needed, reset and re-register your license

Module Not Available Errors

If you see "Plus features module not available":

• Check Installation - Ensure you're using latest Journiv docker image.
• Contact Support - This usually indicates a build configuration issue

Best Practices

Security

• Keep License Key Secure - Don't share your license key
• Verify Emails - Always use the correct registered email

Backup

• Save License Key - Keep your license key in a secure password manager
• Document Install ID - Note your install ID for support purposes
• Keep Receipts - Save purchase confirmation emails

Getting Help

If you need assistance with license management:

• Documentation - Review this guide and related documentation
• Troubleshooting - Check the Troubleshooting Guide
• Community - Ask questions in the Discord community
• Support - Contact support for license-specific issues

Related Topics

• Getting Started - Learn how to register your license
• Features - Discover Plus features
• Troubleshooting - Solve common issues