Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Replace Ngrok with Tunnelmole in your docs for a FOSS Tunneling solution #1629

Open
robbie-cahill opened this issue Jul 8, 2023 · 1 comment
Labels
auto-triage-skip discussion M-T: An issue where more input is needed to reach a decision docs M-T: Documentation work only

Comments

@robbie-cahill
Copy link

I've noticed you have ngrok as your suggested tunneling solution in your docs. However, it has a few issues

  • Its closed source and proprietary
  • It has to be downloaded and installed as an external dependency from ngrok.com
  • You can't self host ngrok and their paid plans are overpriced

So, i'd like to update your docs to use tunnelmole instead. It has the following advantages

  • Its fully open source/FOSS with a permissive MIT license
  • You can self host it for total control or use the hosted service if you want to use it right away
  • It's available as an npm dependency, making installation and updates a lot easier for any JavaScript developer
  • You can run it from code in addition to the command line for more advanced setups

I'd like to update your docs to instruct users to use Tunnelmole for an easier experience.

Here's the difference in terms of set up and usage

Ngrok

First, download and install ngrok seperately from ngrok.com, then run

ngrok http 3000

Tunnelmole

Install from NPM with npm install -g tunnelmole, then run

tunnelmole 3000

Or run from code for more advanced setups:

import { tunnelmole } from 'tunnelmole';
const url = await tunnelmole({
    port: 3000
});
// url = https://idsq6j-ip-157-211-195-169.tunnelmole.com

Let me know if you'd like me to create a PR with these changes.

List any relevant URLs

Requirements

Please read the Contributing guidelines and Code of Conduct before creating this issue or pull request. By submitting, you are agreeing to those rules.

@seratch seratch added docs M-T: Documentation work only discussion M-T: An issue where more input is needed to reach a decision auto-triage-skip and removed untriaged labels Jul 10, 2023
@seratch
Copy link
Member

seratch commented Jul 10, 2023

Hi @robbie-cahill, thank you for reaching out to us!

Your project looks really cool and I believe it would be valuable for many people, including myself! 👍 However, at this moment, we would prefer not to replace any parts of the document, as ngrok is already popular and useful. If we notice more people agreeing to include your OSS product in the documentation, we may consider adding it alongside ngrok in the future, instead of completely replacing it. Until then, let's hold off on making any changes and see what the community members think.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
auto-triage-skip discussion M-T: An issue where more input is needed to reach a decision docs M-T: Documentation work only
Projects
None yet
Development

No branches or pull requests

2 participants