License Management

SetGet uses license keys to activate paid features on self-hosted deployments. When you run SetGet on your own infrastructure instead of using the cloud-hosted service, a license key determines which plan tier your instance operates at. This page covers how to obtain, activate, manage, and transfer license keys.

How licensing works

Self-hosted SetGet instances start with the Free plan feature set. To unlock Pro, Business, or Enterprise features, you apply a license key to your instance. The license key encodes:

• The plan tier (Pro, Business, or Enterprise)
• The maximum number of members
• The expiration date
• The instance identifier (for single-instance licenses)

The instance validates the license on startup and periodically checks its validity. If the license expires or becomes invalid, the instance reverts to Free plan features. Existing data is preserved but paid features become read-only.

Obtaining a license key

1. Visit the SetGet website and navigate to the Pricing page.
2. Select the self-hosted plan that fits your needs.
3. Complete the purchase or contact sales for Enterprise plans.
4. The license key is delivered to the email address of the purchasing account.

License keys are also available in your SetGet account dashboard under Licenses.

Activating a license

Via the admin panel

1. Sign in to your self-hosted SetGet instance as a workspace Admin.
2. Go to Settings > General > License.
3. Paste the license key into the License Key field.
4. Click Activate.
5. The page refreshes and shows the active plan tier, member limit, and expiration date.

Via environment variable

You can also activate a license by setting an environment variable before starting the SetGet API service:

SETGET_LICENSE_KEY=your-license-key-here

When the API starts, it reads the license key from the environment and activates it automatically. This method is useful for automated deployments and infrastructure-as-code workflows.

TIP

The environment variable method is recommended for production deployments because it keeps the license key in your deployment configuration rather than requiring manual activation through the UI.

Viewing license status

After activation, the license status is visible in Settings > General > License. The status panel shows:

Field	Description
Plan	The active plan tier (Pro, Business, Enterprise)
Status	Active, expiring soon, or expired
Members	Current usage vs. licensed maximum
Activated on	Date the license was applied
Expires on	License expiration date
Instance ID	Unique identifier for this instance

Managing licenses

Renewing a license

License keys have an expiration date. To renew:

1. Purchase a renewal through the SetGet website or contact your account manager.
2. You receive a new license key.
3. Apply the new key using the same activation process (admin panel or environment variable).
4. The old key is replaced and the new expiration date takes effect.

WARNING

Renew your license before it expires to avoid interruption. SetGet sends email reminders at 30 days, 14 days, and 3 days before expiration.

Upgrading a license

To upgrade from one plan tier to another (e.g., Pro to Business):

1. Purchase the higher tier on the SetGet website.
2. You receive a new license key for the upgraded plan.
3. Apply the new key to your instance.
4. The upgrade takes effect immediately — no restart required when activated via the admin panel.

Viewing license history

The Settings > General > License page maintains a history of all license keys applied to the instance, including:

• Previous keys (masked for security)
• Activation and deactivation dates
• Plan tier for each key

Transferring a license

If you need to move your SetGet installation to a new server, you can transfer the license:

Standard transfer

1. On the current instance, go to Settings > General > License.
2. Click Deactivate License.
3. Confirm the deactivation. The instance reverts to Free plan features.
4. On the new instance, activate the same license key.

The license key can be activated on one instance at a time. Deactivating it on the old instance frees it for use on the new one.

Transfer with support assistance

If you cannot access the old instance (e.g., hardware failure), contact SetGet support to release the license:

1. Email support with your license key (or the last four characters) and a description of the situation.
2. Support verifies your account ownership.
3. Support releases the license from the old instance.
4. Activate the key on the new instance.

WARNING

Each license key is bound to a single instance at a time. Attempting to activate the same key on a second instance without deactivating the first will fail.

Self-hosted licensing details

Offline activation

For air-gapped environments without internet access, SetGet supports offline license activation:

1. Contact SetGet support to request an offline license file.
2. Provide your instance ID (found in Settings > General > License).
3. Support generates a signed license file tied to your instance ID.
4. Place the license file at the path specified in the documentation or set the SETGET_LICENSE_FILE environment variable to point to it.
5. Restart the API service to apply the license.

License validation

• Online instances validate the license against SetGet servers once every 24 hours.
• Offline instances with a license file validate using the embedded signature — no network call required.
• If validation fails (e.g., network issue on an online instance), there is a 7-day grace period before features revert to Free.

Member counting

The license enforces a maximum member count. Members are counted as:

• Active workspace members (Admin, Member, Guest roles)
• Pending invitations do not count against the limit
• Deactivated accounts do not count against the limit

If you reach the member limit, new invitations are blocked until you remove a member or upgrade the license.

Troubleshooting

Problem	Solution
"Invalid license key" error	Verify you copied the entire key without trailing spaces. Check that the key matches your instance type (cloud keys do not work on self-hosted).
"License already in use" error	Deactivate the key on the other instance first, or contact support for a release.
Features reverted unexpectedly	Check the license expiration date. Ensure the instance can reach SetGet servers for validation (or use offline activation).
Member limit reached	Remove inactive members or upgrade to a higher member tier.

Related pages

• Plans and Pricing — Compare plan features and limits
• Upgrade Your Plan — Cloud plan upgrade process
• Workspace Overview — General workspace settings
• Workspace Members — Member management