Support and FAQ

Using Showoff

Use showoff to share a development server running on a local port. If your development server uses virtual hosts (Apache, Pow, etc), don't forget to specify the virtual hostname.

Share a port

1. You are running a single server on a local port.
2. Use the 'show PORT' command to create a tunnel and public URL.
3. Share the URL to show off your project.

This example assumes you're running a local server on port 3000:

Share a Virtual Host

1. You are running a development server with virtual hosts.
2. Use the 'show VIRTUAL-HOST' command to create a tunnel and public URL.
3. Share the URL to show off your project.

This example assumes you're running a server on port 80 and one of your virtual hosts is called 'mysite.dev':

HTTP Basic Auth

1. You want to show sensitive information.
2. You are concerned someone may stumble across your Share URL.
3. Use show -b USER:PASS ... to secure your project.

This example assumes you're running a local server on port 9292.

When you visit your Share URL, you will see an HTTP basic auth prompt. Enter the username "kept" and password "secret" (or whatever credentials you chose).

Use a CNAME

1. You have an unlimited account.
2. You reserved http://my-name.showoff.io/ as a permanent URL.
3. You have created a DNS CNAME to your permanent URL (e.g. dev.mysite.net resolves to my-name.showoff.io).
4. Use show -c CNAME port to show off your project.

This example assumes you're running a local server on port 8080. CNAME support also works for virtual hosts.

Switch Accounts

1. You have several Showoff accounts.
2. You want to activate a different account.
3. Use show --switch ... to switch.

This example assumes you're running a local server on port 8000

With WordPress

1. You have WordPress installed locally.
2. Use show VIRTUAL-HOST to show it off.

This example assumes you normally access your site as `http://wp.local/`:

WordPress uses absolute URLs for hyperlinks, so people viewing your Share URL will still be refered to a local URL for assets and articles. To fix this, you can do either:

1. Change the "Wordpress address" and "Site address" in "Admin > General Settings" to the Share URL. You will need to change this back when you're done.
2. Add X-Forwarded-Host support. This will dynamically reconfigure host settings when you access a WordPress site through Showoff.

To add X-Forwarded-Host support, download x-forwarded-host.php, drop it into the `wp-includes` folder of your site, then follow the Installation instructions at the top of the file to update `wp-settings.php`.

FAQ