Docs Licensing License Activation Guide

License Activation Guide

Where to Find Your License Key

Your license key is in your purchase confirmation email from trafficexchangescript.com. It has the format:

XXXX-XXXX-XXXX-XXXX

Four groups of four alphanumeric characters separated by dashes. Copy it exactly — it is case-insensitive but leading and trailing spaces will cause validation to fail.

You can also retrieve your license key by logging into your account at trafficexchangescript.com and navigating to Orders → your order → License Keys.


Activating Your License During Installation

License activation is built into the web installer at Step 4 of 7 — License Validation.

  1. Open your browser and visit https://yourdomain.com/install.
  2. Work through Steps 1–3 (requirements check, database, site configuration).
  3. On Step 4 — License Validation, paste your license key into the field and click Validate.
  4. The installer contacts the license server at trafficexchangescript.com to verify your key.
  5. If validation succeeds, the installer proceeds to the next step automatically.
  6. If the license server is temporarily unreachable, you will see a warning and can continue — validation is retried automatically once your site is running.

The installer stores your validated key in .env as TE_LICENSE_KEY when it writes the environment file in Step 6.


Activating a License on an Existing Installation

If you are reinstalling the script or transferring to a new domain, set your license key directly in .env:

  1. Open .env at the root of your installation.
  2. Find the TE_LICENSE_KEY line and set your key:

TE_LICENSE_KEY=XXXX-XXXX-XXXX-XXXX

  1. Also confirm APP_URL is set to the domain this license is registered to:

APP_URL=https://yourdomain.com

  1. Clear the configuration cache so the script picks up the change:

bash php artisan config:clear

On shared hosting without SSH access, delete the contents of bootstrap/cache/ via cPanel File Manager (keep the folder itself, delete only the files inside).

  1. The license will be re-validated on the next daily validation run (see below), or you can trigger it immediately:

bash php artisan te:validate-license


How Ongoing License Validation Works

After installation, the script validates your license automatically every day using the te:validate-license scheduled command. This runs as part of the scheduler — you do not need to do anything once the cron job is configured.

What the daily check does:

  • Sends your license key and domain to the license server
  • If valid: records the successful validation and resets any failure counter
  • If invalid: increments a failure counter and starts a grace period
  • If the license server is unreachable (network issue): no state change — it retries the next day

What happens if validation keeps failing:

If the license server returns an invalid status repeatedly, the script enters a grace period. During this period your site continues to run normally. An admin panel warning will appear to alert you that the license needs attention. If the issue is not resolved, the script may eventually restrict admin access.

If you are seeing repeated validation failures and your license key is correct, contact support at support@trafficexchangescript.com — it is usually a domain mismatch or an account issue that we can resolve quickly.


Validation Status Reference

Status Meaning What to do
completed License valid Nothing — all good
invalid_disabled Your license has been disabled Contact support
invalid_product Key is for a different product Check you copied the right key
activation_limit_exceeded Too many active installs on this key Contact support to review active domains
not_found Key does not exist Check for typos; retrieve key from your account
unreachable License server temporarily unreachable No action needed — retries automatically

Transferring Your License to a New Domain

If you are moving your TE site to a new domain:

  1. Update APP_URL in your .env to the new domain.
  2. Contact support at support@trafficexchangescript.com with your order number and the new domain.
  3. We will update the licensed domain on the license server.
  4. Once updated, run php artisan te:validate-license to trigger an immediate re-validation.

Note: The license server validates against the APP_URL host. If APP_URL and your licensed domain do not match, validation will fail until the license record is updated.


Admin Panel — License Status

After installation, you can check the current license status in the admin panel. A widget on the dashboard shows:

  • Whether the last validation succeeded
  • The date of the last successful validation
  • Any active warning if validation has been failing

Navigate to Admin → Dashboard and look for the License Status indicator. A green status means the license is valid and current.


For issues not listed here, check storage/logs/laravel.log first. License validation errors are logged there with the exact API response. If you are still stuck, contact support at support@trafficexchangescript.com with your order number, the domain in your APP_URL, and the error from the log.

— The Traffic Exchange Script Team

License activation management in Traffic Exchange Script admin panel
The License Management panel confirms your license key, product ID, and activation status — check here if activation fails.

Screenshots

Traffic Exchange Script general settings — site configuration, email, and environment options
Your license key and activation status can be checked and managed from the General Settings panel.
Next New Buyer FAQ