Reference
Configuration Reference
Complete reference table for all GO Shortener environment variables.
Configuration Reference
This page documents every environment variable supported by GO Shortener. All settings should be specified in /root/Go-shortner/.env.
Server & Networking
| Variable | Type | Default | Example Value | Description |
|---|---|---|---|---|
PORT | Integer | 3000 | 3000 | Local TCP port the HTTP server binds to. |
HOST | String | 127.0.0.1 | 127.0.0.1 | Network interface address to listen on. |
BASE_URL | URL | http://localhost:3000 | https://go.arcn.online | Public canonical base URL used for prefixing short links and OAuth redirects. |
APP_ENV | String | production | production | Environment mode (development or production). |
Storage & Database
| Variable | Type | Default | Example Value | Description |
|---|---|---|---|---|
DB_PATH | Path | ./data/go.sqlite | /root/Go-shortner/data/go.sqlite | Path to the SQLite database file on disk. Parent directories are created automatically. |
Security & Sessions
| Variable | Type | Default | Example Value | Description |
|---|---|---|---|---|
JWT_SECRET | String | (Auto-generated) | 4f9e8a7b6c5d4e3f2a1b0c9d8e7f6a5b | 32+ character random string used for cryptographic session signing. |
SESSION_DURATION_HOURS | Integer | 72 | 72 | Validity period of the go_session cookie in hours. |
Quotas & Lifecycles
| Variable | Type | Default | Example Value | Description |
|---|---|---|---|---|
ANONYMOUS_DAILY_QUOTA | Integer | 15 | 15 | Maximum number of short links an anonymous visitor can create per 24 hours. |
REGISTERED_MONTHLY_QUOTA | Integer | 100 | 100 | Maximum number of short links a standard registered user can create per calendar month. |
ANONYMOUS_MAX_EXPIRATION_DAYS | Integer | 7 | 7 | Ceiling duration (in days) for anonymous short links. |
REGISTERED_MAX_EXPIRATION_DAYS | Integer | 365 | 365 | Ceiling duration (in days) for registered user links. |
Cloudflare Turnstile CAPTCHA
| Variable | Type | Default | Example Value | Description |
|---|---|---|---|---|
TURNSTILE_ENABLED | Boolean | false | true | Toggle Turnstile CAPTCHA verification on forms. |
TURNSTILE_SITE_KEY | String | "" | 0x4AAAAAA... | Public site key loaded in browser widgets. |
TURNSTILE_SECRET_KEY | String | "" | 0x4AAAAAA... | Confidential secret key used for server-side verification. |
Firebase Authentication (Google OAuth)
| Variable | Type | Default | Example Value | Description |
|---|---|---|---|---|
FIREBASE_API_KEY | String | "" | AIzaSy... | Firebase Web App API Key. |
FIREBASE_AUTH_DOMAIN | String | "" | project.firebaseapp.com | Firebase Web App Auth Domain. |
FIREBASE_PROJECT_ID | String | "" | my-project-id | Firebase Project Identifier. |
FIREBASE_STORAGE_BUCKET | String | "" | project.firebasestorage.app | Firebase Storage Bucket. |
FIREBASE_MESSAGING_SENDER_ID | String | "" | 1234567890 | Firebase Cloud Messaging Sender ID. |
FIREBASE_APP_ID | String | "" | 1:123456:web:abcdef | Firebase Web App Identifier. |
Development Seed Credentials
| Variable | Type | Default | Example Value | Description |
|---|---|---|---|---|
ADMIN_BOOTSTRAP_EMAIL | String | "" | admin@example.com | Seed email used only on fresh installs if no users exist. |
ADMIN_BOOTSTRAP_PASSWORD | String | "" | ChangeMe123! | Seed password used only on fresh installs if no users exist. |