Documentation

Everything you need to deploy and use AltENV.

Quick Start

1. Get a License Key

Start a 30-day free trial or purchase a plan. Your license key will be emailed to you.

2. Deploy with Docker

docker run -d \
  --name altenv \
  -p 8888:8888 \
  -e ALTENV_LICENSE_KEY=your-license-key \
  -v altenv-data:/data \
  altenv/server:latest

That's it. The dashboard is now available at http://your-server:8888.

3. Set the Master Password

On first run, the dashboard will prompt you to set a master password. This derives the encryption key for all stored secrets.

4. Add Your First Proxy

Click "Add Proxy" in the dashboard. Enter a name (e.g., "OpenAI"), paste your API key, select the auth method (e.g., Bearer), and save. You'll get a proxy code like maple4521.

5. Use the Proxy URL

Replace the API base URL in your code or .env file:

# .env
OPENAI_API_KEY=unused
OPENAI_BASE_URL=http://your-server:8888/p/maple4521

Your SDK works normally. AltENV injects the real API key on every request.

Portal Sharing

AltENV can also reverse-proxy web portals so your team shares login sessions without seeing the password.

Add a Portal

In the dashboard, click "Add Portal". Enter the portal URL (e.g., https://admin.example.com), give it a slug, and log in via the AltENV proxy. The session cookies are stored server-side.

Browser Extension

The AltENV browser extension gives your team one-click access to portals and API keys.

Install the extension from the Chrome Web Store (or load unpacked for Firefox)
Click the AltENV icon and enter the join link provided by your admin
Wait for admin approval
Portals and API keys appear in the extension popup

Device Management

Admins can approve or deny devices, assign specific portal and API access per device, and revoke access at any time.

Configuration

Environment Variables

ALTENV_LICENSE_KEY — Your license key (required)
ALTENV_PORT — Server port (default: 8888)
ALTENV_DATA_DIR — Data directory (default: /data)

Support

Need help? Email support@altenv.dev