README

Instant public URLs for Laravel development. Expose your local app with a single command — supports token auth, reserved subdomains, and custom domains.

xpos.dev

Features

One Command — php artisan xpos gets you a public HTTPS URL instantly
Token Auth — longer sessions, reserved subdomains, and custom domains with an XPOS token
Reserved Subdomains — keep myapp.xpos.to across sessions (Pro plan)
Custom Domains — use your own domain like dev.example.com (Business plan)
Auto-Start Server — starts php artisan serve automatically if not running
Auto TrustProxies — HTTPS URLs work correctly out of the box
Laravel 10, 11, 12 — full support

Installation

composer require getxpos/laravel --dev

Quick Start

# Anonymous tunnel (random subdomain, 3hr expiry)
php artisan xpos

That's it. The command starts your dev server (if needed), opens an SSH tunnel, and displays your public URL.

Authentication

For longer sessions and more features, add your XPOS token to .env:

XPOS_TOKEN=tk_your_token_here

Get your token at xpos.dev/dashboard/tokens.

Usage

# Anonymous tunnel (random subdomain, 3hr expiry)
php artisan xpos

# Authenticated tunnel (uses XPOS_TOKEN from .env)
php artisan xpos

# Reserved subdomain (Pro plan)
php artisan xpos --subdomain=myapp

# Custom domain (Business plan)
php artisan xpos --domain=dev.example.com

# Override token from command line
php artisan xpos --token=tk_your_token

# Use a specific port
php artisan xpos --port=8080

# Use an existing server (skip starting artisan serve)
php artisan xpos --no-serve --port=3000

# Bind to a specific host
php artisan xpos --host=0.0.0.0

Configuration

Publish the config file:

php artisan vendor:publish --tag=xpos-config

Options in config/xpos.php:

Key	Default	Description
`token`	`env('XPOS_TOKEN')`	Auth token from xpos.dev dashboard
`server`	`go.xpos.dev`	XPOS tunnel server
`ssh_port`	`443`	SSH port
`default_port`	`8000`	Default dev server port
`trust_proxies`	`true`	Auto-configure TrustProxies for HTTPS

HTTPS & TrustProxies

The package automatically configures Laravel's TrustProxies middleware so asset(), url(), route(), and other helpers generate correct HTTPS URLs when accessed through an XPOS tunnel.

This works with *.xpos.to subdomains, custom domains, and any future tunnel domains. Disable with XPOS_TRUST_PROXIES=false in .env if needed.

Requirements

PHP 8.1+
Laravel 10, 11, or 12
SSH client in PATH

Troubleshooting

Port already in use?

php artisan xpos --port=8001

SSH connection issues?

Ensure SSH client is installed and in PATH
Check firewall settings for port 443

HTTPS URLs not working?

Ensure trust_proxies is true in config/xpos.php
Clear config cache: php artisan config:clear

Reserved subdomain not working?

Ensure XPOS_TOKEN is set in .env
Verify your plan supports reserved subdomains at xpos.dev

.gitignore

Add .xpos.pid to your project's .gitignore:

.xpos.pid

License

MIT License. See LICENSE for details.

getxpos / laravel

Maintainers

Package info

Statistics

Security