Licensing

tvaras requires a valid enterprise license key. The license is validated on startup and periodically during operation.


How It Works

  1. Set ENTERPRISE_KEY in your .env file
  2. On startup, the bot validates the key against tvaras.ai
  3. Every 4 hours, the key is re-validated automatically
  4. If validation fails, API requests are blocked (HTTP 402)

Grace Period

If the license server is temporarily unreachable, the bot uses its cached validation for up to 24 hours. This ensures brief network issues don't disrupt your operations.

License Information

View your license details at Admin → License:

  • Status — Valid / Invalid / Expired
  • Organization — your company name
  • License type — trial / standard / enterprise
  • Expiration date
  • Max users — user limit (0 = unlimited for enterprise)
  • Instance ID — unique identifier for this deployment
  • Last validated — timestamp of last successful check

Manual Refresh

Click Refresh on the License page to force an immediate re-validation.

What Happens When a License Expires

  • The bot continues running but blocks all API requests
  • Users see a license error when trying to use the chat
  • The admin panel remains accessible
  • Automatic updates stop (the update script validates the license before pulling)

Obtaining a License

  • Free 14-day trial — if your stack runs on Google BigQuery + dbt, start a self-serve trial at tvaras.ai/trial. Sign in with your company Google account and your trial license key is issued instantly — no credit card. One trial per company; colleagues who sign in join the same trial.
  • Paid plans — contact us at vej.ai to obtain or renew a license key.

Trial Licenses

Trial keys behave exactly like paid keys (same validation, same bootstrap script) and expire 14 days after signup. Have a coupon code? Enter it on the trial page before signing in — coupons can grant a longer trial period. When a trial expires the instance keeps running and your data stays put, but API requests are blocked until the key is upgraded — reach out at hello@vej.ai to continue.