Installation

#

We provide multiple installation methods depending on your local development environment. Simply pick the option that works best for you.

Laravel Herd

#

If you are using Laravel Herd, Expose is already available in your terminal and you are ready to go. Simply set up your token and share your first site.

PHP Archive (PHAR)

#

We distribute Expose as a PHAR archive that contains everything you need in order to use Expose. Simply download it from here and make it executable. This method only works if you have a modern version of PHP installed.

curl https://github.com/exposedev/expose/raw/master/builds/expose -L --output expose

chmod +x expose

./expose

You most likely want to put the expose.phar into a directory on your PATH, so you can simply call expose from any directory. For example:

sudo mv expose.phar /usr/local/bin/expose

After that, you are ready to go and can share your first site.

Via Composer

#

Expose is a PHP application and you can install the client for your local machine as a global composer dependency:

composer global require exposedev/expose

Make sure that your global composer directory is inside of your PATH environment variable. Simply add this directory to your PATH in your ~/.bash_profile (or ~/.bashrc) like this:

export PATH=~/.composer/vendor/bin:$PATH

Extending Expose

#

By default, Expose comes as an executable PHAR file. This allows you to use all Expose features out of the box – without any additional setup required.

If you want to modify Expose and want to add custom request or response modifiers, you can learn more about customization options in the documentation for Request Plugins.

Updating the Expose client

#

You can update the Expose client to the latest version by running the self-update command.

expose self-update