📧 Configuration

.env Reference — All Environment Variables

Last updated: March 14, 2026 5 min read

This is an annotated reference for every environment variable in Traffic Exchange Script’s .env file. Start from .env.example (included in your download) and fill in values as described below.

App Basics

Variable	Default	Description
`APP_NAME`	`Laravel`	Internal Laravel app name. Set this to match your site.
`APP_ENV`	`local`	Set to `production` on a live server.
`APP_KEY`	(empty)	Application encryption key. Generate with `php artisan key:generate`. Required.
`APP_DEBUG`	`true`	Set to `false` in production. Never expose debug output publicly.
`APP_URL`	`http://localhost`	Your site’s full URL including protocol (e.g. `https://yourdomain.com`). Required.

Hosting Mode

Variable	Default	Description
`TE_HOSTING_MODE`	`auto`	`auto` \| `shared` \| `vps`. See Getting Started.

Database

Variable	Default	Description
`DB_CONNECTION`	`mysql`	Database driver. MySQL 8.0 required.
`DB_HOST`	`127.0.0.1`	Database host. Use `db` when running Docker.
`DB_PORT`	`3306`	Database port.
`DB_DATABASE`	`traffic_exchange`	Database name.
`DB_USERNAME`	`root`	Database username.
`DB_PASSWORD`	(empty)	Database password.

Cache, Session, and Queue

Variable	Default	Description
`SESSION_DRIVER`	`file`	`file` for shared hosting, `redis` for VPS.
`SESSION_LIFETIME`	`120`	Session lifetime in minutes.
`CACHE_STORE`	`file`	`file` for shared hosting, `redis` for VPS.
`QUEUE_CONNECTION`	`database`	`database` for shared hosting, `redis` for VPS.

Redis

Variable	Default	Description
`REDIS_HOST`	`127.0.0.1`	Redis server host. Use `redis` in Docker.
`REDIS_PASSWORD`	`null`	Redis password (if configured).
`REDIS_PORT`	`6379`	Redis port.

Mail

Variable	Default	Description
`MAIL_MAILER`	`log`	`log` (dev), `smtp`, `sendgrid`, `mailgun`, `ses`.
`MAIL_HOST`	`127.0.0.1`	SMTP server hostname.
`MAIL_PORT`	`2525`	SMTP port (common: 587 for TLS, 465 for SSL).
`MAIL_USERNAME`	`null`	SMTP username.
`MAIL_PASSWORD`	`null`	SMTP password.
`MAIL_ENCRYPTION`	`null`	`tls` or `ssl`.
`MAIL_FROM_ADDRESS`	`hello@example.com`	The from address for all system emails.
`MAIL_FROM_NAME`	`${APP_NAME}`	The from name for all system emails.

Traffic Exchange — General

Variable	Default	Description
`TE_APP_NAME`	`My Traffic Exchange`	Your site’s display name, shown to members.
`TE_LICENSE_KEY`	(empty)	Your license key from your purchase. Required.
`TE_SUPPORT_EMAIL`	`support@example.com`	Support contact email shown to members.
`TE_ADMIN_PATH`	`admin`	URL path for the admin panel (e.g. change to `myadmin` for security).
`TE_SUBSCRIPTION_MAX_RETRIES`	`3`	Max dunning retry attempts before subscription is cancelled.

Surf Engine Timers

Variable	Default	Description
`TE_SURF_MANUAL_TIMER`	`10`	Default manual surf timer in seconds.
`TE_SURF_AUTO_TIMER`	`8`	Default auto surf timer in seconds.
`TE_SURF_POPUP_TIMER`	`6`	Default popup surf timer in seconds.
`TE_SURF_TIMER_REDUCTION_ENABLED`	`false`	Enable marathon mode (timer reduces as surfer views more pages).
`TE_SURF_TIMER_REDUCTION_THRESHOLD`	`50`	Views per session before timer reduction kicks in.
`TE_SURF_TIMER_REDUCTION_AMOUNT`	`1`	Seconds to reduce per threshold crossing.
`TE_SURF_TIMER_REDUCTION_MAX`	`3`	Maximum total reduction in seconds.
`TE_SURF_TIMER_MINIMUM`	`3`	Minimum allowed timer after reduction (seconds).
`TE_SURF_MANUAL_PAUSE_TIMEOUT`	`300`	Seconds of tab inactivity before surf session enters idle state.
`TE_AUTO_SURF_SESSION_LIMIT`	`100`	Max sites per auto surf session (0 = unlimited).
`TE_AUTO_SURF_DAILY_LIMIT`	`200`	Max sites per day in auto surf (0 = unlimited).
`TE_AUTO_SURF_MAX_SESSION_DURATION`	`120`	Max auto surf session duration in minutes.
`TE_SURF_POPUP_MAX_CONCURRENT`	`3`	Max concurrent popup windows in popup surf mode.
`TE_SURF_HEALTH_CHECK_MAX_FAILURES`	`3`	Consecutive health check failures before a site is auto-paused.

Variable	Default	Description
`TE_CREDITS_SIGNUP_BONUS`	`100`	Manual surf credits awarded on registration.
`TE_CREDITS_AUTO_SIGNUP_BONUS`	`0`	Auto surf credits awarded on registration.
`TE_CREDITS_POPUP_SIGNUP_BONUS`	`0`	Popup credits awarded on registration.
`TE_BANNER_CREDITS_SIGNUP_BONUS`	`0`	Banner ad credits awarded on registration.
`TE_TEXT_AD_CREDITS_SIGNUP_BONUS`	`0`	Text ad credits awarded on registration.
`TE_PTC_CREDITS_SIGNUP_BONUS`	`0`	PTC credits awarded on registration.
`TE_POINTS_SIGNUP_BONUS`	`50`	Points awarded on registration.

Withdrawals

Variable	Default	Description
`TE_MIN_WITHDRAWAL`	`5.00`	Minimum withdrawal amount in USD.

Payment Gateways

PayPal

Variable	Description
`PAYPAL_CLIENT_ID`	PayPal app Client ID
`PAYPAL_CLIENT_SECRET`	PayPal app Client Secret
`PAYPAL_SANDBOX`	`true` for testing, `false` for live
`PAYPAL_WEBHOOK_ID`	PayPal webhook ID

Stripe

Variable	Description
`STRIPE_KEY`	Stripe publishable key (`pk_live_...`)
`STRIPE_SECRET`	Stripe secret key (`sk_live_...`)
`STRIPE_WEBHOOK_SECRET`	Stripe webhook signing secret (`whsec_...`)

JVZoo

Variable	Description
`JVZOO_SECRET_KEY`	JVZoo IPN secret key
`JVZOO_API_KEY`	JVZoo API key

WarriorPlus

Variable	Description
`WARRIORPLUS_SECRET_KEY`	WarriorPlus IPN secret key
`WARRIORPLUS_API_KEY`	WarriorPlus API key

Explodely

Variable	Description
`EXPLODELY_API_KEY`	Explodely API key
`EXPLODELY_WEBHOOK_SECRET`	Explodely webhook secret
`EXPLODELY_STORE_ID`	Explodely store ID

ClickBank

Variable	Description
`CLICKBANK_ACCOUNT_NICKNAME`	ClickBank account nickname
`CLICKBANK_SECRET_KEY`	ClickBank secret key
`CLICKBANK_DEV_KEY`	ClickBank developer key

Internal Balance

Variable	Default	Description
`INTERNAL_BALANCE_MIN_BALANCE`	`0.00`	Minimum balance required for internal balance purchases

Anti-Cheat Settings

Variable	Default	Description
`TE_CAPTCHA_ENABLED`	`true`	Enable CAPTCHA challenges during surfing.
`TE_CAPTCHA_FREQUENCY`	`15`	Show CAPTCHA every N views under normal conditions.
`TE_CAPTCHA_ADAPTIVE_ENABLED`	`true`	Enable adaptive CAPTCHA (more frequent for suspicious members).
`TE_VPN_DETECTION_ENABLED`	`true`	Enable VPN/proxy detection.
`TE_FINGERPRINT_ENABLED`	`true`	Enable browser fingerprinting for multi-account detection.
`TE_MAX_CHEAT_SCORE`	`100`	Maximum cheat score (member flagged for review at this threshold).
`TE_PROXY_DETECTION_ACTION`	`warn`	Action when VPN/proxy detected: `warn`, `block_surf`, `ban`.
`TE_DATACENTER_IP_ACTION`	`block_surf`	Action for datacenter IPs: `warn`, `block_surf`, `ban`.
`TE_AUTOMATION_DETECTION_ACTION`	`warn`	Action when headless/bot browser detected: `warn`, `terminate`, `ban`.
`TE_CHEAT_SCORE_DECAY_RATE`	`0.5`	Points removed from cheat score per day.
`TE_TEMP_BAN_DURATION`	`3600`	Temp surf ban duration in seconds (default: 1 hour).
`TE_EXTENDED_BAN_DURATION`	`86400`	Extended ban duration in seconds (default: 24 hours).

Reverb WebSocket (VPS Only)

Variable	Default	Description
`REVERB_APP_ID`	(empty)	Reverb app ID
`REVERB_APP_KEY`	(empty)	Reverb app key
`REVERB_APP_SECRET`	(empty)	Reverb app secret
`REVERB_HOST`	`localhost`	Reverb server hostname
`REVERB_PORT`	`8080`	Reverb server port
`REVERB_SCHEME`	`http`	`http` or `https`

Web Push Notifications (VAPID)

Variable	Description
`VAPID_SUBJECT`	Your site URL or `mailto:` address
`VAPID_PUBLIC_KEY`	Generated by `php artisan te:generate-vapid-keys`
`VAPID_PRIVATE_KEY`	Generated by `php artisan te:generate-vapid-keys`

GeoIP Paths

Variable	Default	Description
`TE_MAXMIND_DB_PATH`	`storage/geoip/GeoLite2-City.mmdb`	Path to the MaxMind GeoLite2 database. Updated by `php artisan te:update-geoip`.
`TE_DATACENTER_BLOCKLIST_PATH`	`storage/datacenter-ips.txt`	Path to the datacenter IP blocklist.

Traffic Exchange Script admin general settings reflecting .env configuration — Many .env variables are reflected in the General Settings panel — verify your environment config here after deployment.

Screenshots

Traffic Exchange Script general settings — site configuration, email, and environment options — The General Settings panel maps to many of the .env variables — changes here update your site configuration directly.