Help to get this working

[MeestorX]

It sounds like at least some of you have been able to get this working?

I would like to create my own expose server to tunnel a TCP Port on a local computer just like nGrok can do.
I created a DO Docker droplet.
Installed expose
Not sure what to do next?

What app do I download to the client? With nGrok there's a Windows/Mac/Linux app for the local computer that's going to share it's port.

What command(s) do I run on my server?

I've gone through the documentation many times and I'm missing a few key steps...

Thanks for taking pity on me, anyone kind enough to help! :-)

[cpxPratik]

You can install and use Expose client(on your local machine) as follows:

Installing Expose client

• Install Expose as global composer dependency

composer global require beyondcode/expose

• If composer's vendor bin direcotry is not added on PATH environment variable, add following line at the end of .bashrc or .zshrc file located on your home directory.

On Linux system,

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

On macOS,

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

• Reload .bashrc or .zshrc by running source ~/.bashrc or source ~/.zshrc

• Run expose publish to publish Expose configuration file at ~/.expose/config.php. Refer https://beyondco.de/docs/expose/client/configuration for more details.

• Update host value to your_expose_domain on file ~/.expose/config.php

• Ask Expose admin for authentication token to connect to your_expose_domain server.

• Run expose token <your_auth_token> . It updates ~/.expose/config.php with token value.

Using Expose client

• Run your app on your local machine then share it with expose share http://127.0.0.1:<local_app_port> --subdomain=<sub_domain>

expose share http://127.0.0.1:<local_port> --subdomain=rest-skeleton

• Refer https://beyondco.de/docs/expose/client/sharing for more details

• To share local site with custom basic authentication credentials, add parameter with --auth="<basic_auth_username>:<basic_auth_password

expose share http://127.0.0.1:<local_port> --subdomain=rest-skeleton --auth="admin:test123456"

[MeestorX]

@cpxPratik thank you so much!
Gave up on the docker and used composer. The PATH info was missing from the instructions, particularly for MacOS.

now, how does one share a TCP port?
On Ngrok it’s: ngrok tcp <ip>:<port>

I tried:
expose share-port <ip>:<port> --subdomain=andy

It does not work, as per #123 (comment)

[MeestorX]

Anyone?

[mpociot]

TCP port sharing is only available in the master branch and will land in version 2.x. You can already set up your own server to use this though

[MeestorX]

Go on...

That is my goal to use my own server. Do you have instructions on how to do TCP port sharing on my own server?

[ghostzero]

There is a documentation available that explain how to host your own server. You may want to check this out:
https://beyondco.de/docs/expose/server/starting-the-server

[MeestorX]

Right, I've read that. I'm talking about instructions on how to share TCP ports specifically.

[MeestorX]

Anyone?

[MeestorX]

Friendly bump in case anyone’s figured out how to share TCP ports yet?

[ghost]

Yeah this is a bit frustrating.

You guys are so innovative and productive, but you need to hire someone to write documentation.

I created a Forge server, added my domain, installed SSL.

I downloaded the package and then created a repo for it, then imported it as an app into my domain on Forge.

I adjusted the config to represent the correct domain and port 443, I added your configuration for Nginx to map / to 127.0.0.1:8080.

I opened port 8080 just in case it was needed. I created a daemon to run php expose serve mydomain.com

I visit the site and a see an SSL encrypted homepage. So far so good.

Now, locally I installed the package globally:

composer require -g beyondcode/expose

I publish the config and edit it accordingly, adding the domain of my server and port 443

And then ....

when I run expose share mysite.test --subdomain=example I get nothing ... no feedback, no error nothing.

It just hangs forever.

So .... I think ... maybe I need to start a local server for it to work? So I run:

expose serve mydomain.com

Expose reports that it's running on port 8080 ... which is NOT what's in the config, but either way.

Still, trying to share a site produces nothing at all, just a hanging process.

Meanwhile ... I have a server burning that does nothing.

What's the hold up on these issues?

[warren-bank]

fwiw, here is a fully working example that I used to test using expose to tunnel an HLS Proxy server.

I didn't see any need to use Docker or composer. The expose repo includes a PHAR that only needs a PHP binary on PATH to run.

• scripts are written for Windows cmd (not bash, sorry)
• test scenario:
  • update the system's hosts file
  • run HLS Proxy server on localhost:8080
  • run expose server on my-domain:9090
    • in this scenario, the updated system hosts file forces DNS to resolve my-domain to localhost
    • in a real-world scenario, a registered domain would be used that will be resolved by a public DNS server
  • run expose client on same machine as HLS Proxy server
    • endpoint of tunnel is on same machine as expose server
    • it is accessed at the static subdomain hls-proxy.my-domain:9090