JournivJourniv
Journiv Plus

Getting Started with Journiv Plus

Step-by-step guide to purchasing, registering, and using your Journiv Plus license.

This guide will walk you through getting started with Journiv Plus, from purchasing a license to using your first Plus feature.

Choose Your Deployment Mode

Before registering your license, decide how you want Journiv Plus to run:

  • Inline mode: the default and simplest setup. Plus runs inside the main Journiv app container.
  • Sidecar mode: the preferred option for privacy-focused deployments. Plus runs in a separate container and Journiv connects to it over an internal network.

Use sidecar mode if you want Journiv Plus isolated from public internet access or if you are deploying in an air-gapped environment. The Docker installation guide covers the optional sidecar compose file.

Step 1: Get Your License

Where to Purchase

Journiv Plus licenses can be purchased here. Once you have purchased a license, you will receive a license key via email within 48 hours. Please ensure to use a valid email address when purchasing a license. Your license key will be valid for 1 year from the date of license email sent (not the date of purchase).

License Key Format

Your license key will look like this:

lic_abc123def456ghi789jkl012mno345pq

Important: Keep your license key secure and treat it as a password. You'll need it to register Plus features on your instance.

Step 2: Access License Settings

To register your license, you need admin access to your Journiv instance:

  1. Log In - Sign in to your Journiv instance as an administrator
  2. Navigate to Settings - Click on "Settings" in the navigation menu
  3. Open License Section - Click on "Journiv Plus" or navigate to /settings/license

You should see the license management screen, which shows:

  • Current license status (if any)
  • License registration form
  • License information and actions

Step 3: Register Your License

Registration Form

The license registration form requires:

  1. License Key - Your 36-character license key (starts with lic_)
  2. Email Address - The email address associated with your license purchase
  3. Discord ID (Optional) - Your Discord username if you want to join the Plus discord channel on Journiv Discord server.

Registration Steps

  1. Enter License Key - Paste your complete license key into the "License Key" field
  2. Enter Email - Enter the email address you used when purchasing the license
  3. Add Discord ID (Optional) - If you want to join the Plus Discord group, enter your Discord username
  4. Click Register - Click the "Register License" button

What Happens During Registration

When you register your license:

  1. Validation - Your license key is validated with the license server
  2. Binding - The license is bound to your installation's unique ID
  3. Activation - Plus features are immediately activated
  4. Confirmation - You'll see a success message and your license details

Registration Requirements

  • Admin Access - Only administrators can register licenses
  • Internet Connection - Registration requires internet access to validate with the license server
  • Valid License - Your license must be active and not expired
  • Email Match - The email you enter must match the license owner's email

Step 4: Verify Your License

After registration, you should see:

  • License Status - Shows "Active" if your license is valid
  • Expiration Date - Shows when your license expires
  • Install ID - Your unique installation identifier

Step 5: Access Plus Features

Once your license is registered, Plus features are immediately available:

Tag Analytics

  1. Navigate to Tags - Go to Settings → Tags
  2. Open Analytics Tab - Click on the "Analytics" tab
  3. View Analytics - Explore your tag usage statistics and trends

Public Publishing and oEmbed

After Plus is active, you can also use Plus-powered publishing features:

  1. Publish selected entries - Share specific entries at public URLs
  2. Control indexing - Decide whether a published entry should be indexable by search engines
  3. Use richer embeds - Published entries support oEmbed for compatible services and platforms
  4. Offer public PDFs - Published entries can expose a public PDF download

Feature Availability

Plus features are automatically enabled when:

  • Your license is registered
  • Your license is active (not expired)
  • Your license is valid (not revoked)

If a feature shows a "Plus Feature" message, check that:

  • Your license is registered
  • Your license status is "Active"

Troubleshooting Registration

Common Issues

"License registration failed"

  • Verify your license key is correct (36 characters, starts with lic_)
  • Ensure your email matches the license owner's email
  • Check your internet connection
  • Try refreshing the page and registering again

"Rate limit exceeded"

  • You can register a license up to 2 times per day per license
  • Wait 24 hours before trying again
  • Contact support if you need immediate assistance

"Email mismatch"

  • The email you enter must exactly match the email used when purchasing the license
  • Check your purchase confirmation email for the correct email address

Getting Help

If you encounter issues during registration:

  1. **Check License ** - Verify your license key and email are correct
  2. Review Error Messages - Read the error message carefully for specific guidance
  3. Try Again - Sometimes network issues cause temporary failures
  4. Contact Support - Reach out through Discord or email if problems persist

After Registration

What You Can Do Now

  • Use Tag Analytics - Access detailed tag usage insights
  • Publish selected entries publicly - Share specific posts without exposing your private journal
  • Use oEmbed-ready published posts - Get richer previews for supported embeds
  • Explore Features - Try out all available Plus features
  • Manage License - View and manage your license settings
  • Monitor Expiration - Keep track of license expiration dates and renew your license when needed

Next Steps

Security Notes

  • Keep License Key Secure - Don't share your license key with anyone
  • Admin Access Required - Only administrators can register and manage licenses
  • Install ID Binding - Your license is tied to your specific installation to prevent unauthorized use. You have a limited number of attempts to reset/re-register your license to a new installations in a month.