Files
expose/docs/getting-started/sharing-your-first-site.md
2021-06-14 16:49:29 +02:00

2.2 KiB

title, order
title order
Share your first site 2

Share your first site

If you are on macOS and use Laravel Valet as your local development environment, the easiest way to share your local sites is by going into the folder that you want to share and run the expose command from your command line:

cd ~/Sites/my-awesome-project/

expose

The expose command assumes that your local site is available at http://my-awesome-project.test.

This command uses your Expose network token and connects to the Expose network server at sharedwithexpose.com and creates a tunnel. If you don't have an Expose token and don't want to host your own server, you can create a free account and get a token here.

If you run a different operating system or your local application runs in a virtual machine, Docker or uses a custom URL scheme, you can share the site by adding more parameters to the command. To learn more about sharing your local sites, check out the sharing local sites documentation.

Using the Expose network at sharedwithexpose.com

Expose is the only open source tunnel service that is written in PHP. This means that you can host your own server and this on its own makes it a fantastic alternative to ngrok.

Before you install your own server, you can try Expose with the free plan of the Expose network and see if your like the features for PHP developers. To access the Expose network, you need an Expose token.

You can obtain a token by signing in to your Beyond Code account. If you don't have an account, you can sign up and create an account for free.

Authenticating with sharedwithexpose.com

To register and use the given credentials, just run the following command:

expose token [YOUR-AUTH-TOKEN]

This will register the token globally in your expose configuration file and all following Expose calls will automatically use the token to authenticate with the network. In case that you have access to a team on an Expose Pro plan, you can use this command to switch to the team and get access to the reserved subdomains or white label domains.