LinuxCommandLibrary

expose

Not a standard Linux command

TLDR

Register your authentication token

$ expose token [token]
copy

Share the current working directory
$ expose
copy

Share the current working directory with a specific subdomain
$ expose --subdomain=[subdomain]
copy

Share a local URL
$ expose share [url]
copy

Run the Expose server
$ expose serve
copy

Run the Expose server with a specific hostname
$ expose serve [hostname]
copy

SYNOPSIS

expose share <url> [options]

PARAMETERS

--subdomain=SUBDOMAIN
    Use custom subdomain for the tunnel

--type=TYPE
    Tunnel type: http, https, or tcp (default: http)

--password[=PASSWORD]
    Password-protect the tunnel

--allow-ignore-ssl
    Ignore self-signed SSL certificates

--region=REGION
    Select tunnel region (e.g., us, eu)

DESCRIPTION

expose is a third-party command-line tool designed to create secure tunnels from your local machine to the public internet, allowing easy sharing of local web servers or TCP services without complex setup. Popular among developers, especially PHP/Laravel users, it provides a simple alternative to tools like ngrok. Install via Composer (composer global require beyondcode/expose) or Homebrew on Linux. Once installed, run expose share with a local URL to get a public URL. Supports HTTP/HTTPS/TCP tunnels, custom subdomains, password protection, and SSL bypassing for self-signed certs. It uses a relay server for tunneling and is not part of core Linux utilities. Usage is straightforward for quick demos or client previews. Note: Requires internet access and account optional for advanced features. Free tier available with limitations on concurrent tunnels.

CAVEATS

Not a standard Linux command; third-party tool. Requires installation. Free version limits concurrent tunnels. Traffic routed through third-party servers; review privacy. No persistence across restarts.

INSTALLATION

Linux: curl -s https://expose.dev/install.sh | sh or Composer.

OTHER USES

May refer to kubectl expose (Kubernetes) or Exposé window switcher in Compiz/i3.

HISTORY

Developed by Beyond Code (Marcel Pociot) in 2018 as a Laravel Forge companion. Open-source on GitHub, actively maintained with PHP backend. Gained popularity in PHP community for simplicity over ngrok.

SEE ALSO

ngrok(1), localtunnel(1)

Copied to clipboard