Skip to content

Commit

Permalink
docs: scheme -> url
Browse files Browse the repository at this point in the history
  • Loading branch information
warrn committed Aug 23, 2024
1 parent 9dbf691 commit 8c232c5
Show file tree
Hide file tree
Showing 4 changed files with 7 additions and 8 deletions.
1 change: 0 additions & 1 deletion docs/agent/cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -412,7 +412,6 @@ ngrok http https://localhost:8443 # forward to a local https server
| `--request-header-remove strings` | header field to remove from request if present |
| `--response-header-add strings` | header key:value to add to response |
| `--response-header-remove strings` | header field to remove from response if present |
| `--scheme strings` | which scheme to listen on (default `https`) |
| `--traffic-policy-file string` | path to traffic policy configuration YAML or JSON file (See [Traffic Policy](/http/traffic-policy/?cty=agent-cli)) |
| `--ua-filter-allow strings` | a list of regular expressions for user-agents to allow |
| `--ua-filter-deny strings` | a list of regular expressions for user-agents to deny |
Expand Down
2 changes: 1 addition & 1 deletion docs/agent/config.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -493,7 +493,7 @@ tunnels:
ngrok start httpbin
```

Each tunnel you define is a map of configuration option names to values. The name of a configuration option is usually the same as its corresponding command line switch with hyphens (`--host-header` becomes `host_header:` in the configuration file and `--scheme` becomes `schemes`). Tunnels can define a specific `proto` or use labels to dynamically connect to one or more matching ngrok Edges. All tunnels must define a specific `addr` that tells the agent where to send the traffic. Other properties are available and many are protocol-specific.
Each tunnel you define is a map of configuration option names to values. The name of a configuration option is usually the same as its corresponding command line switch with hyphens (`--host-header` becomes `host_header:` in the configuration file and `--url` becomes `url`). Tunnels can define a specific `proto` or use labels to dynamically connect to one or more matching ngrok Edges. All tunnels must define a specific `addr` that tells the agent where to send the traffic. Other properties are available and many are protocol-specific.

##### Start all tunnels defined in the configuration file

Expand Down
2 changes: 1 addition & 1 deletion docs/errors/details/_err_ngrok_3200.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ ngrok is unable to assist with end user content as all content is neither hosted
- **Endpoint Domain or Hostname Change** The endpoint domain or hostname has changed. If you are on the Free plan or have not set the `--domain` flag to set the domain on the tunnel, please be aware that the forwarding address will change each time the Agent and session are restarted. If you previously obtained a forwarding URL from an agent session but have since closed that session or closed the client window, the URL will change when a new Agent session starts.
- **Typo in Endpoint Address** You have made a typo in the endpoint address you have entered in the browser. Verify that the tunnel hostname is correct. Incorrectly entering the address (a typo) in a browser address bar can also result in this error.
- **Network Issues** A network issue exists between the device the Agent is running on and ngrok. Your ngrok agent might have trouble reaching the ngrok service. Try running the [`ngrok diagnose`](/docs/agent/cli/#ngrok-diagnose) command to check for connectivity issues.
- **Incorrect Scheme** You are attempting to run `--scheme http` on your agent using a domain that only supports https. All of the `.app` and `.dev` domains are HSTS or "HTTP Strict Transport Security" domains. Paid plan accounts are able to start http scheme tunnels on the `ngrok.io` domain, which is not HSTS enforced.
- **Incorrect Scheme** You are attempting to run `--url http://...` on your agent using a domain that only supports https. All of the `.app` and `.dev` domains are HSTS or "HTTP Strict Transport Security" domains. Paid plan accounts are able to start http scheme tunnels on the `ngrok.io` domain, which is not HSTS enforced.

If you are the Administrator for this ngrok account, and none of these steps work for you or you have additional questions, drop us a note at [[email protected]](mailto:[email protected]?subject=Help%20with%20ngrok%203200%20error).
10 changes: 5 additions & 5 deletions docs/guides/upgrade-v2-v3.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,17 +18,17 @@ ngrok config check

This will automatically add `version` and `region` options as well as convert the names of legacy options to their new format. If you're only using ngrok with a configuration file, there's nothing else to do. For more information about the changes to the config file, see the [following section](#upgrading-the-ngrok-agent-config).

**Only HTTPS tunnels by default** - ngrok agent HTTP tunnels by default will only open a single HTTPS endpoint for your upstream service instead of both an HTTP and HTTPS endpoint. To enable both, you will need to add `--scheme http --scheme https` to your ngrok agent command or configuration file.
**Only HTTPS tunnels by default** - ngrok agent HTTP tunnels by default will only open a single HTTPS endpoint for your upstream service instead of both an HTTP and HTTPS endpoint. In order to setup both an HTTP and an HTTPS endpoint, configure multiple endpoints via the configuration file.

**Automation using the ngrok agent** - If you have written any scripts or built wrappers around the ngrok agent using command line flags, there are additional changes you will need to make.

- Installing the Authtoken is now done with the command `ngrok config add-authtoken TOKEN`. Check out the [ngrok config reference documentation](/agent/cli#ngrok-config) for more information.
- The ngrok agent only accepts long name flags prefixed with `--` and will error if a single hyphen is used. When updating your scripts, ensure flags like `--host-header` are using double hyphens.
- The following command flags have changed:
- `-auth` -> [`--basic-auth`](/agent/cli/#ngrok-http)
- `-bind-tls` -> [`--scheme`](/agent/cli/#ngrok-http)
- `-hostname` -> [`--domain`](/agent/cli/#ngrok-http)
- `-subdomain` -> [`--domain subdomain.ngrok-free.dev`](/agent/cli/#ngrok-http)
- `-bind-tls` -> [`--url`](/agent/cli/#ngrok-http)
- `-hostname` -> [`--url`](/agent/cli/#ngrok-http)
- `-subdomain` -> [`--url subdomain.ngrok-free.dev`](/agent/cli/#ngrok-http)

For a full list of changes to the agent for v3, see the [changelog](/agent/changelog).

Expand Down Expand Up @@ -88,7 +88,7 @@ The latest version of the ngrok agent includes an updated command line argument
- The ngrok agent only accepts long name flags prefixed with `--` and will error if a single hyphen is used. When updating your scripts, ensure things like `--hostname` and `--host-header` are using double hyphens.
- The following command flags have changed:
- `-auth` -> [`--basic-auth`](/agent/cli/#ngrok-http)
- `-bind-tls` -> [`--scheme`](/agent/cli/#ngrok-http)
- `-bind-tls` -> [`--url`](/agent/cli/#ngrok-http)

### Next steps

Expand Down

0 comments on commit 8c232c5

Please sign in to comment.