diff --git a/docs/getting-started.mdx b/docs/getting-started.mdx index baac06ef..7f4e2345 100644 --- a/docs/getting-started.mdx +++ b/docs/getting-started.mdx @@ -211,50 +211,17 @@ Resources that are shared _publicly_ are exposed to any users on the internet wh A frontend is an HTTPS listener exposed to the internet, that lets any user with your ephemeral share token access your publicly shared resources. -For example, I might create a public share using the `zrok share public` command, which results in my `zrok` instance exposing a URL like `https://2ptgbr8tlfvk.share.zrok.io` to access my resources. +For example, I might create a public share using the `zrok share public` command, which results in my `zrok` instance exposing a URL like `https://xxr2b7tzfx64.share.zrok.io` to access my resources. -In this case, my share was given the "share token" of `2ptgbr8tlfvk`. That URL can be given to any user, allowing them to immediately access the shared resources directly from my local environment, all without exposing any access to my private, secure environment. The physical network location of my environment is not exposed to anonymous consumers of my resources. - -:::note -Here is the `--help` output from `zrok share public`: - -```text -zrok share public +``` +$ zrok share public --backend-mode web . ``` -```buttonless title="Output" -Error: accepts 1 arg(s), received 0 -Usage: - zrok share public [flags] - -Flags: - --backend-mode string The backend mode {proxy, web, caddy, drive} (default "proxy") - --basic-auth stringArray Basic authentication users (,...) - --frontends stringArray Selected frontends to use for the share (default [public]) - --headless Disable TUI and run headless - -h, --help help for public - --insecure Enable insecure TLS certificate validation for - -Global Flags: - -p, --panic Panic instead of showing pretty errors - -v, --verbose Enable verbose logging - -[ERROR]: an error occurred (accepts 1 arg(s), received 0) -``` - -`` defines the path to the local resource that you intend to share. The form of `` depends on the `--backend-mode` that you're using. - -In the case of `--backend-mode proxy`, `` should be a URL to an HTTP endpoint. - -In the case of `--backend-mode web`, `` is the path to a file on disk that serves as the "root" of the file tree to be shared. -::: +In this case, my share was given the "share token" of `xxr2b7tzfx64`. That URL can be given to any user, allowing them to immediately access the shared resources directly from my local environment, all without exposing any access to my private, secure environment. The physical network location of my environment is not exposed to anonymous consumers of my resources. If we return to the web console, we see our share in the explorer: -![Web Console Share](images/zrok_web_console_explorer_share.png) - -If we click on our new share in the explorer, we can see the share details: -![Share Details](images/zrok_web_console_share_detail.png) +![Web Console Share](images/zrok-visualizer-public-share.png) If we click on the _frontend endpoint_ a new browser tab opens and we see the content of our share: ![Share Frontend](images/zrok_web_console_share_frontend.png) diff --git a/docs/images/zrok-visualizer-environment.png b/docs/images/zrok-visualizer-environment.png old mode 100755 new mode 100644 diff --git a/docs/images/zrok-visualizer-public-share.png b/docs/images/zrok-visualizer-public-share.png new file mode 100644 index 00000000..5429331e Binary files /dev/null and b/docs/images/zrok-visualizer-public-share.png differ diff --git a/docs/images/zrok-visualizer-sparklines.png b/docs/images/zrok-visualizer-sparklines.png new file mode 100644 index 00000000..3fe5367f Binary files /dev/null and b/docs/images/zrok-visualizer-sparklines.png differ diff --git a/docs/images/zrok-zoom-to-fit.png b/docs/images/zrok-zoom-to-fit.png old mode 100755 new mode 100644