License Setup

Activate your enterprise license to unlock advanced features.

Get Your License

Sign in to the ZapFS portal
Choose a plan and complete checkout
Download your license key from the dashboard
Configure ZapFS to use your license (see below)

Installation Methods

Option 1: File-based (Recommended)

Place your license key file at the default location:

# Create the config directory
sudo mkdir -p /etc/zapfs

# Copy your license file
sudo cp ~/Downloads/zapfs-license.key /etc/zapfs/license.key

# Set appropriate permissions
sudo chmod 600 /etc/zapfs/license.key

# Restart ZapFS services
sudo systemctl restart zapfs-manager
sudo systemctl restart zapfs-metadata

Option 2: Environment Variable

Set the license key as an environment variable:

# Read the license file and export
export ZAPFS_LICENSE_KEY=$(cat ~/Downloads/zapfs-license.key)

# Or add to your shell profile for persistence
echo 'export ZAPFS_LICENSE_KEY="..."' >> ~/.bashrc

Option 3: Kubernetes Secret

For Kubernetes deployments, create a secret:

# Create secret from license file
kubectl create secret generic zapfs-license \
  --from-file=license.key=~/Downloads/zapfs-license.key \
  -n zapfs

# Or create from literal
kubectl create secret generic zapfs-license \
  --from-literal=license.key="$(cat ~/Downloads/zapfs-license.key)" \
  -n zapfs

Then update your Helm values:

# values.yaml
enterprise:
  enabled: true
  license:
    existingSecret: zapfs-license
    secretKey: license.key

Verify License

Check that your license is active:

# Check license status via API
curl http://localhost:8060/v1/license

# Expected response
{
  "valid": true,
  "tier": "professional",
  "features": ["access_log", "advanced_metrics", "ldap", "oidc", "kms", "lifecycle", "backup"],
  "expires_at": "2025-01-15T00:00:00Z",
  "max_nodes": 25,
  "max_capacity_tb": 100
}

License Expiration

ZapFS licenses are tied to your subscription billing period. When your subscription renews, a new license is automatically generated. You can download the updated license from your dashboard at any time.

If your license expires:

Enterprise features will be disabled
Core S3 functionality continues to work
Data remains accessible and intact
Renew your subscription to restore enterprise features

Troubleshooting

Issue	Solution
License not found	Check file path or environment variable is set correctly
Invalid signature	Re-download license from dashboard; file may be corrupted
License expired	Renew subscription and download new license
Feature not available	Check your tier includes the feature; upgrade if needed

Need help? Contact [email protected]