diff --git a/404.html b/404.html index 3c164620..8c9fecde 100644 --- a/404.html +++ b/404.html @@ -9,7 +9,7 @@ - + diff --git a/assets/js/11b43341.fa8647ec.js b/assets/js/11b43341.93b3652a.js similarity index 54% rename from assets/js/11b43341.fa8647ec.js rename to assets/js/11b43341.93b3652a.js index 2faf57e5..a20dc1a2 100644 --- a/assets/js/11b43341.fa8647ec.js +++ b/assets/js/11b43341.93b3652a.js @@ -1 +1 @@ -"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[9585],{7793:e=>{e.exports=JSON.parse('{"version":{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"tutorialSidebar":[{"type":"link","label":"Getting Started","href":"/docs/getting-started","docId":"getting-started","unlisted":false},{"type":"category","label":"Concepts","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Private Shares","href":"/docs/concepts/sharing-private","docId":"concepts/sharing-private","unlisted":false},{"type":"link","label":"Public Shares","href":"/docs/concepts/sharing-public","docId":"concepts/sharing-public","unlisted":false},{"type":"link","label":"Reserved Shares","href":"/docs/concepts/sharing-reserved","docId":"concepts/sharing-reserved","unlisted":false},{"type":"link","label":"Sharing HTTP Servers","href":"/docs/concepts/http","docId":"concepts/http","unlisted":false},{"type":"link","label":"Sharing TCP and UDP Servers","href":"/docs/concepts/tunnels","docId":"concepts/tunnels","unlisted":false},{"type":"link","label":"Sharing Websites and Files","href":"/docs/concepts/files","docId":"concepts/files","unlisted":false},{"type":"link","label":"Open Source","href":"/docs/concepts/opensource","docId":"concepts/opensource","unlisted":false},{"type":"link","label":"Hosting","href":"/docs/concepts/hosting","docId":"concepts/hosting","unlisted":false}],"href":"/docs/concepts/"},{"type":"category","label":"Guides","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Install","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Linux","href":"/docs/guides/install/linux","docId":"guides/install/linux","unlisted":false},{"type":"link","label":"macOS","href":"/docs/guides/install/macos","docId":"guides/install/macos","unlisted":false},{"type":"link","label":"Windows","href":"/docs/guides/install/windows","docId":"guides/install/windows","unlisted":false}],"href":"/docs/guides/install/"},{"type":"link","label":"frontdoor","href":"/docs/guides/frontdoor","docId":"guides/frontdoor","unlisted":false},{"type":"link","label":"Permission Modes","href":"/docs/guides/permission-modes","docId":"guides/permission-modes","unlisted":false},{"type":"category","label":"Docker Share","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Public Share","href":"/docs/guides/docker-share/docker_public_share_guide","docId":"guides/docker-share/docker_public_share_guide","unlisted":false},{"type":"link","label":"Private Share","href":"/docs/guides/docker-share/docker_private_share_guide","docId":"guides/docker-share/docker_private_share_guide","unlisted":false}],"href":"/docs/guides/docker-share/"},{"type":"category","label":"Self Hosting","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Linux","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"NGINX TLS","href":"/docs/guides/self-hosting/linux/nginx","docId":"guides/self-hosting/linux/nginx","unlisted":false}],"href":"/docs/guides/self-hosting/linux/"},{"type":"link","label":"Interstitial Pages","href":"/docs/guides/self-hosting/interstitial-page","docId":"guides/self-hosting/interstitial-page","unlisted":false},{"type":"link","label":"Personalized Frontend","href":"/docs/guides/self-hosting/personalized-frontend","docId":"guides/self-hosting/personalized-frontend","unlisted":false},{"type":"link","label":"Docker","href":"/docs/guides/self-hosting/docker","docId":"guides/self-hosting/docker","unlisted":false},{"type":"link","label":"Kubernetes","href":"/docs/guides/self-hosting/kubernetes","docId":"guides/self-hosting/kubernetes","unlisted":false},{"type":"category","label":"Metrics and Limits","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuring Metrics","href":"/docs/guides/self-hosting/metrics-and-limits/configuring-metrics","docId":"guides/self-hosting/metrics-and-limits/configuring-metrics","unlisted":false},{"type":"link","label":"Configuring Limits","href":"/docs/guides/self-hosting/metrics-and-limits/configuring-limits","docId":"guides/self-hosting/metrics-and-limits/configuring-limits","unlisted":false}],"href":"/docs/category/metrics-and-limits"},{"type":"category","label":"OAuth","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"OAuth Public Frontend Configuration","href":"/docs/guides/self-hosting/oauth/configuring-oauth","docId":"guides/self-hosting/oauth/configuring-oauth","unlisted":false}],"href":"/docs/category/oauth"},{"type":"link","label":"Instance Config","href":"/docs/guides/self-hosting/instance-configuration","docId":"guides/self-hosting/instance-configuration","unlisted":false},{"type":"link","label":"Invitations","href":"/docs/guides/self-hosting/self-service-invite","docId":"guides/self-hosting/self-service-invite","unlisted":false}],"href":"/docs/category/self-hosting"},{"type":"category","label":"drives","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"The Drives CLI","href":"/docs/guides/drives/cli","docId":"guides/drives/cli","unlisted":false}]},{"type":"link","label":"VPN","href":"/docs/guides/vpn/","docId":"guides/vpn/vpn","unlisted":false}],"href":"/docs/category/guides"}]},"docs":{"concepts/files":{"id":"concepts/files","title":"Sharing Websites and Files","description":"With zrok it is possible to share files quickly and easily as well. To share files using zrok use","sidebar":"tutorialSidebar"},"concepts/hosting":{"id":"concepts/hosting","title":"Hosting","description":"Self-Hosted","sidebar":"tutorialSidebar"},"concepts/http":{"id":"concepts/http","title":"Sharing HTTP Servers","description":"zrok can share HTTP and HTTPS resources natively. If you have an existing web server that you want to share with other users, you can use the zrok share command using the --backend-mode proxy flag.","sidebar":"tutorialSidebar"},"concepts/index":{"id":"concepts/index","title":"Concepts","description":"zrok was designed to make sharing local resources both secure and easy. In this section of the zrok documentation, we\'ll tour through all of the most important features.","sidebar":"tutorialSidebar"},"concepts/opensource":{"id":"concepts/opensource","title":"Open Source","description":"It\'s important to the zrok project that it remain free and open source software. The code is available on GitHub","sidebar":"tutorialSidebar"},"concepts/sharing-private":{"id":"concepts/sharing-private","title":"Private Shares","description":"zrok was built to share and access digital resources. A private share allows a resource to be","sidebar":"tutorialSidebar"},"concepts/sharing-public":{"id":"concepts/sharing-public","title":"Public Shares","description":"zrok supports public sharing for web-based (HTTP and HTTPS) resources. These resources are easily shared with the general internet through public access points.","sidebar":"tutorialSidebar"},"concepts/sharing-reserved":{"id":"concepts/sharing-reserved","title":"Reserved Shares","description":"By default a public or private share is assigned a share token when you create a share using the zrok share command. The zrok share command is the bridge between your local environment and the users you are sharing with. When you terminate the zrok share, the bridge is eliminated and the share token is deleted. If you run zrok share again, you will be allocated a brand new share token.","sidebar":"tutorialSidebar"},"concepts/tunnels":{"id":"concepts/tunnels","title":"Sharing TCP and UDP Servers","description":"zrok includes support for sharing low-level TCP and UDP network resources using the tcpTunnel and udpTunnel backend modes.","sidebar":"tutorialSidebar"},"getting-started":{"id":"getting-started","title":"Getting Started with zrok","description":"Get an Account","sidebar":"tutorialSidebar"},"guides/docker-share/docker_private_share_guide":{"id":"guides/docker-share/docker_private_share_guide","title":"Docker Private Share","description":"Goal","sidebar":"tutorialSidebar"},"guides/docker-share/docker_public_share_guide":{"id":"guides/docker-share/docker_public_share_guide","title":"Docker Compose Public Share","description":"Goal","sidebar":"tutorialSidebar"},"guides/docker-share/index":{"id":"guides/docker-share/index","title":"Getting Started with Docker","description":"Overview","sidebar":"tutorialSidebar"},"guides/drives/cli":{"id":"guides/drives/cli","title":"The Drives CLI","description":"The zrok drives CLI tools allow for simple, ergonomic management and synchronization of local and remote files.","sidebar":"tutorialSidebar"},"guides/frontdoor":{"id":"guides/frontdoor","title":"zrok frontdoor","description":"zrok frontdoor is the heavy-duty front door to your app or site. It makes your website or app available to your online audience through the shield of zrok.io\'s hardened, managed frontends.","sidebar":"tutorialSidebar"},"guides/install/index":{"id":"guides/install/index","title":"Install","description":"{e.exports=JSON.parse('{"version":{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"tutorialSidebar":[{"type":"link","label":"Getting Started","href":"/docs/getting-started","docId":"getting-started","unlisted":false},{"type":"category","label":"Concepts","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Private Shares","href":"/docs/concepts/sharing-private","docId":"concepts/sharing-private","unlisted":false},{"type":"link","label":"Public Shares","href":"/docs/concepts/sharing-public","docId":"concepts/sharing-public","unlisted":false},{"type":"link","label":"Reserved Shares","href":"/docs/concepts/sharing-reserved","docId":"concepts/sharing-reserved","unlisted":false},{"type":"link","label":"Sharing HTTP Servers","href":"/docs/concepts/http","docId":"concepts/http","unlisted":false},{"type":"link","label":"Sharing TCP and UDP Servers","href":"/docs/concepts/tunnels","docId":"concepts/tunnels","unlisted":false},{"type":"link","label":"Sharing Websites and Files","href":"/docs/concepts/files","docId":"concepts/files","unlisted":false},{"type":"link","label":"Open Source","href":"/docs/concepts/opensource","docId":"concepts/opensource","unlisted":false},{"type":"link","label":"Hosting","href":"/docs/concepts/hosting","docId":"concepts/hosting","unlisted":false}],"href":"/docs/concepts/"},{"type":"category","label":"Guides","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Install","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Linux","href":"/docs/guides/install/linux","docId":"guides/install/linux","unlisted":false},{"type":"link","label":"macOS","href":"/docs/guides/install/macos","docId":"guides/install/macos","unlisted":false},{"type":"link","label":"Windows","href":"/docs/guides/install/windows","docId":"guides/install/windows","unlisted":false}],"href":"/docs/guides/install/"},{"type":"link","label":"frontdoor","href":"/docs/guides/frontdoor","docId":"guides/frontdoor","unlisted":false},{"type":"link","label":"Permission Modes","href":"/docs/guides/permission-modes","docId":"guides/permission-modes","unlisted":false},{"type":"category","label":"Docker Share","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Public Share","href":"/docs/guides/docker-share/docker_public_share_guide","docId":"guides/docker-share/docker_public_share_guide","unlisted":false},{"type":"link","label":"Private Share","href":"/docs/guides/docker-share/docker_private_share_guide","docId":"guides/docker-share/docker_private_share_guide","unlisted":false}],"href":"/docs/guides/docker-share/"},{"type":"category","label":"Self Hosting","collapsible":true,"collapsed":true,"items":[{"type":"category","label":"Linux","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"NGINX TLS","href":"/docs/guides/self-hosting/linux/nginx","docId":"guides/self-hosting/linux/nginx","unlisted":false}],"href":"/docs/guides/self-hosting/linux/"},{"type":"link","label":"Interstitial Pages","href":"/docs/guides/self-hosting/interstitial-page","docId":"guides/self-hosting/interstitial-page","unlisted":false},{"type":"link","label":"Personalized Frontend","href":"/docs/guides/self-hosting/personalized-frontend","docId":"guides/self-hosting/personalized-frontend","unlisted":false},{"type":"link","label":"Docker","href":"/docs/guides/self-hosting/docker","docId":"guides/self-hosting/docker","unlisted":false},{"type":"link","label":"Kubernetes","href":"/docs/guides/self-hosting/kubernetes","docId":"guides/self-hosting/kubernetes","unlisted":false},{"type":"category","label":"Metrics and Limits","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Configuring Metrics","href":"/docs/guides/self-hosting/metrics-and-limits/configuring-metrics","docId":"guides/self-hosting/metrics-and-limits/configuring-metrics","unlisted":false},{"type":"link","label":"Configuring Limits","href":"/docs/guides/self-hosting/metrics-and-limits/configuring-limits","docId":"guides/self-hosting/metrics-and-limits/configuring-limits","unlisted":false}],"href":"/docs/category/metrics-and-limits"},{"type":"category","label":"OAuth","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"OAuth Public Frontend Configuration","href":"/docs/guides/self-hosting/oauth/configuring-oauth","docId":"guides/self-hosting/oauth/configuring-oauth","unlisted":false}],"href":"/docs/category/oauth"},{"type":"link","label":"Instance Config","href":"/docs/guides/self-hosting/instance-configuration","docId":"guides/self-hosting/instance-configuration","unlisted":false},{"type":"link","label":"Invitations","href":"/docs/guides/self-hosting/self-service-invite","docId":"guides/self-hosting/self-service-invite","unlisted":false}],"href":"/docs/category/self-hosting"},{"type":"category","label":"drives","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"The Drives CLI","href":"/docs/guides/drives/cli","docId":"guides/drives/cli","unlisted":false}]},{"type":"link","label":"VPN","href":"/docs/guides/vpn/","docId":"guides/vpn/vpn","unlisted":false}],"href":"/docs/category/guides"}]},"docs":{"concepts/files":{"id":"concepts/files","title":"Sharing Websites and Files","description":"With zrok it is possible to share files quickly and easily as well. To share files using zrok use","sidebar":"tutorialSidebar"},"concepts/hosting":{"id":"concepts/hosting","title":"Hosting","description":"Self-Hosted","sidebar":"tutorialSidebar"},"concepts/http":{"id":"concepts/http","title":"Sharing HTTP Servers","description":"zrok can share HTTP and HTTPS resources natively. If you have an existing web server that you want to share with other users, you can use the zrok share command using the --backend-mode proxy flag.","sidebar":"tutorialSidebar"},"concepts/index":{"id":"concepts/index","title":"Concepts","description":"zrok was designed to make sharing local resources both secure and easy. In this section of the zrok documentation, we\'ll tour through all of the most important features.","sidebar":"tutorialSidebar"},"concepts/opensource":{"id":"concepts/opensource","title":"Open Source","description":"It\'s important to the zrok project that it remain free and open source software. The code is available on GitHub","sidebar":"tutorialSidebar"},"concepts/sharing-private":{"id":"concepts/sharing-private","title":"Private Shares","description":"zrok was built to share and access digital resources. A private share allows a resource to be","sidebar":"tutorialSidebar"},"concepts/sharing-public":{"id":"concepts/sharing-public","title":"Public Shares","description":"zrok supports public sharing for web-based (HTTP and HTTPS) resources. These resources are easily shared with the general internet through public access points.","sidebar":"tutorialSidebar"},"concepts/sharing-reserved":{"id":"concepts/sharing-reserved","title":"Reserved Shares","description":"By default, a public or private share is assigned a share token when you create a share using the zrok share command. The zrok share command is the bridge between your local environment and the users you are sharing with. When you terminate the zrok share, the bridge is eliminated and the share token is deleted. If you run zrok share again, you will be allocated a brand new share token.","sidebar":"tutorialSidebar"},"concepts/tunnels":{"id":"concepts/tunnels","title":"Sharing TCP and UDP Servers","description":"zrok includes support for sharing low-level TCP and UDP network resources using the tcpTunnel and udpTunnel backend modes.","sidebar":"tutorialSidebar"},"getting-started":{"id":"getting-started","title":"Getting Started with zrok","description":"Get an Account","sidebar":"tutorialSidebar"},"guides/docker-share/docker_private_share_guide":{"id":"guides/docker-share/docker_private_share_guide","title":"Docker Private Share","description":"Goal","sidebar":"tutorialSidebar"},"guides/docker-share/docker_public_share_guide":{"id":"guides/docker-share/docker_public_share_guide","title":"Docker Compose Public Share","description":"Goal","sidebar":"tutorialSidebar"},"guides/docker-share/index":{"id":"guides/docker-share/index","title":"Getting Started with Docker","description":"Overview","sidebar":"tutorialSidebar"},"guides/drives/cli":{"id":"guides/drives/cli","title":"The Drives CLI","description":"The zrok drives CLI tools allow for simple, ergonomic management and synchronization of local and remote files.","sidebar":"tutorialSidebar"},"guides/frontdoor":{"id":"guides/frontdoor","title":"zrok frontdoor","description":"zrok frontdoor is the heavy-duty front door to your app or site. It makes your website or app available to your online audience through the shield of zrok.io\'s hardened, managed frontends.","sidebar":"tutorialSidebar"},"guides/install/index":{"id":"guides/install/index","title":"Install","description":"{s.r(r),s.d(r,{assets:()=>d,contentTitle:()=>a,default:()=>l,frontMatter:()=>o,metadata:()=>i,toc:()=>h});var n=s(5893),t=s(1151);const o={sidebar_position:10},a="Reserved Shares",i={id:"concepts/sharing-reserved",title:"Reserved Shares",description:"By default, a public or private share is assigned a share token when you create a share using the zrok share command. The zrok share command is the bridge between your local environment and the users you are sharing with. When you terminate the zrok share, the bridge is eliminated and the share token is deleted. If you run zrok share again, you will be allocated a brand new share token.",source:"@site/../docs/concepts/sharing-reserved.md",sourceDirName:"concepts",slug:"/concepts/sharing-reserved",permalink:"/docs/concepts/sharing-reserved",draft:!1,unlisted:!1,editUrl:"https://github.com/openziti/zrok/blob/main/docs/../docs/concepts/sharing-reserved.md",tags:[],version:"current",sidebarPosition:10,frontMatter:{sidebar_position:10},sidebar:"tutorialSidebar",previous:{title:"Public Shares",permalink:"/docs/concepts/sharing-public"},next:{title:"Sharing HTTP Servers",permalink:"/docs/concepts/http"}},d={},h=[{value:"Unique Names",id:"unique-names",level:2}];function c(e){const r={code:"code",em:"em",h1:"h1",h2:"h2",header:"header",p:"p",pre:"pre",...(0,t.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(r.header,{children:(0,n.jsx)(r.h1,{id:"reserved-shares",children:"Reserved Shares"})}),"\n",(0,n.jsxs)(r.p,{children:["By default, a ",(0,n.jsx)(r.code,{children:"public"})," or ",(0,n.jsx)(r.code,{children:"private"})," share is assigned a ",(0,n.jsx)(r.em,{children:"share token"})," when you create a share using the ",(0,n.jsx)(r.code,{children:"zrok share"})," command. The ",(0,n.jsx)(r.code,{children:"zrok share"})," command is the bridge between your local environment and the users you are sharing with. When you terminate the ",(0,n.jsx)(r.code,{children:"zrok share"}),", the bridge is eliminated and the ",(0,n.jsx)(r.em,{children:"share token"})," is deleted. If you run ",(0,n.jsx)(r.code,{children:"zrok share"})," again, you will be allocated a brand new ",(0,n.jsx)(r.em,{children:"share token"}),"."]}),"\n",(0,n.jsxs)(r.p,{children:["You can use a ",(0,n.jsx)(r.code,{children:"reserved"})," share to persist your ",(0,n.jsx)(r.em,{children:"share token"})," across multiple runs of the ",(0,n.jsx)(r.code,{children:"zrok share"})," bridge. When you use a ",(0,n.jsx)(r.code,{children:"reserved"})," share, the share token will not be deleted between multiple runs of ",(0,n.jsx)(r.code,{children:"zrok share"}),"."]}),"\n",(0,n.jsxs)(r.p,{children:["To use a ",(0,n.jsx)(r.code,{children:"reserved"})," share, you will first run the ",(0,n.jsx)(r.code,{children:"zrok reserve"})," command to create the reserved share (see ",(0,n.jsx)(r.code,{children:"zrok reserve --help"})," for details). Once you've created your ",(0,n.jsx)(r.code,{children:"reserved"})," share, you will use the ",(0,n.jsx)(r.code,{children:"zrok share reserved"})," command (see ",(0,n.jsx)(r.code,{children:"--help"})," for details) to run the bridge for the shared resource."]}),"\n",(0,n.jsxs)(r.p,{children:["This pattern works for both ",(0,n.jsx)(r.code,{children:"public"})," and ",(0,n.jsx)(r.code,{children:"private"})," shares, and for all resource types supported by ",(0,n.jsx)(r.code,{children:"zrok"}),"."]}),"\n",(0,n.jsxs)(r.p,{children:["To delete your ",(0,n.jsx)(r.code,{children:"reserved"})," share use the ",(0,n.jsx)(r.code,{children:"zrok release"})," command or click the delete button in the share's ",(0,n.jsx)(r.em,{children:"Actions"})," tab in the web console."]}),"\n",(0,n.jsx)(r.h2,{id:"unique-names",children:"Unique Names"}),"\n",(0,n.jsxs)(r.p,{children:["The default is to generate a random ",(0,n.jsx)(r.em,{children:"share token"})," and you may specify a ",(0,n.jsx)(r.em,{children:"unique name"}),"."]}),"\n",(0,n.jsx)(r.p,{children:'This reserves public share token "myshare."'}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-bash",metastring:'title="Reserve with the Command Line"',children:'zrok reserve public 80 --unique-name "myshare"\n'})}),"\n",(0,n.jsxs)(r.p,{children:["This shares ",(0,n.jsx)(r.code,{children:"127.0.0.1:80"})," as ",(0,n.jsx)(r.code,{children:"https://myshare.zrok.example.com"})," where ",(0,n.jsx)(r.code,{children:"https://{token}.zrok.example.com"})," is the frontend's template."]}),"\n",(0,n.jsx)(r.pre,{children:(0,n.jsx)(r.code,{className:"language-bash",metastring:'title="Share a Reserved Token"',children:'zrok share reserved "myshare"\n'})})]})}function l(e={}){const{wrapper:r}={...(0,t.a)(),...e.components};return r?(0,n.jsx)(r,{...e,children:(0,n.jsx)(c,{...e})}):c(e)}},1151:(e,r,s)=>{s.d(r,{Z:()=>i,a:()=>a});var n=s(7294);const t={},o=n.createContext(t);function a(e){const r=n.useContext(o);return n.useMemo((function(){return"function"==typeof e?e(r):{...r,...e}}),[r,e])}function i(e){let r;return r=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:a(e.components),n.createElement(o.Provider,{value:r},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/6272ba0e.b4fcb5f7.js b/assets/js/6272ba0e.b4fcb5f7.js deleted file mode 100644 index 4dab56e6..00000000 --- a/assets/js/6272ba0e.b4fcb5f7.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[7176],{516:(e,r,s)=>{s.r(r),s.d(r,{assets:()=>i,contentTitle:()=>d,default:()=>l,frontMatter:()=>t,metadata:()=>a,toc:()=>c});var n=s(5893),o=s(1151);const t={sidebar_position:10},d="Reserved Shares",a={id:"concepts/sharing-reserved",title:"Reserved Shares",description:"By default a public or private share is assigned a share token when you create a share using the zrok share command. The zrok share command is the bridge between your local environment and the users you are sharing with. When you terminate the zrok share, the bridge is eliminated and the share token is deleted. If you run zrok share again, you will be allocated a brand new share token.",source:"@site/../docs/concepts/sharing-reserved.md",sourceDirName:"concepts",slug:"/concepts/sharing-reserved",permalink:"/docs/concepts/sharing-reserved",draft:!1,unlisted:!1,editUrl:"https://github.com/openziti/zrok/blob/main/docs/../docs/concepts/sharing-reserved.md",tags:[],version:"current",sidebarPosition:10,frontMatter:{sidebar_position:10},sidebar:"tutorialSidebar",previous:{title:"Public Shares",permalink:"/docs/concepts/sharing-public"},next:{title:"Sharing HTTP Servers",permalink:"/docs/concepts/http"}},i={},c=[];function h(e){const r={code:"code",em:"em",h1:"h1",header:"header",p:"p",...(0,o.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(r.header,{children:(0,n.jsx)(r.h1,{id:"reserved-shares",children:"Reserved Shares"})}),"\n",(0,n.jsxs)(r.p,{children:["By default a ",(0,n.jsx)(r.code,{children:"public"})," or ",(0,n.jsx)(r.code,{children:"private"})," share is assigned a ",(0,n.jsx)(r.em,{children:"share token"})," when you create a share using the ",(0,n.jsx)(r.code,{children:"zrok share"})," command. The ",(0,n.jsx)(r.code,{children:"zrok share"})," command is the bridge between your local environment and the users you are sharing with. When you terminate the ",(0,n.jsx)(r.code,{children:"zrok share"}),", the bridge is eliminated and the ",(0,n.jsx)(r.em,{children:"share token"})," is deleted. If you run ",(0,n.jsx)(r.code,{children:"zrok share"})," again, you will be allocated a brand new ",(0,n.jsx)(r.em,{children:"share token"}),"."]}),"\n",(0,n.jsxs)(r.p,{children:["You can use a ",(0,n.jsx)(r.code,{children:"reserved"})," share to persist your ",(0,n.jsx)(r.em,{children:"share token"})," across multiple runs of the ",(0,n.jsx)(r.code,{children:"zrok share"})," bridge. When you use a ",(0,n.jsx)(r.code,{children:"reserved"})," share, the share token will not be deleted between multiple runs of ",(0,n.jsx)(r.code,{children:"zrok share"}),"."]}),"\n",(0,n.jsxs)(r.p,{children:["To use a ",(0,n.jsx)(r.code,{children:"reserved"})," share, you will first run the ",(0,n.jsx)(r.code,{children:"zrok reserve"})," command to create the reserved share (see ",(0,n.jsx)(r.code,{children:"zrok reserve --help"})," for details). Once you've created your ",(0,n.jsx)(r.code,{children:"reserved"})," share, you will use the ",(0,n.jsx)(r.code,{children:"zrok share reserved"})," command (see ",(0,n.jsx)(r.code,{children:"--help"})," for details) to run the bridge for the shared resource."]}),"\n",(0,n.jsxs)(r.p,{children:["This pattern works for both ",(0,n.jsx)(r.code,{children:"public"})," and ",(0,n.jsx)(r.code,{children:"private"})," shares, and for all resource types supported by ",(0,n.jsx)(r.code,{children:"zrok"}),"."]}),"\n",(0,n.jsxs)(r.p,{children:["To delete your ",(0,n.jsx)(r.code,{children:"reserved"})," share use the ",(0,n.jsx)(r.code,{children:"zrok release"})," command or click the delete button in the share's ",(0,n.jsx)(r.em,{children:"Actions"})," tab in the web console."]})]})}function l(e={}){const{wrapper:r}={...(0,o.a)(),...e.components};return r?(0,n.jsx)(r,{...e,children:(0,n.jsx)(h,{...e})}):h(e)}},1151:(e,r,s)=>{s.d(r,{Z:()=>a,a:()=>d});var n=s(7294);const o={},t=n.createContext(o);function d(e){const r=n.useContext(t);return n.useMemo((function(){return"function"==typeof e?e(r):{...r,...e}}),[r,e])}function a(e){let r;return r=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:d(e.components),n.createElement(t.Provider,{value:r},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.0b80049b.js b/assets/js/runtime~main.70819bfa.js similarity index 97% rename from assets/js/runtime~main.0b80049b.js rename to assets/js/runtime~main.70819bfa.js index 2fba7f64..9b8db93a 100644 --- a/assets/js/runtime~main.0b80049b.js +++ b/assets/js/runtime~main.70819bfa.js @@ -1 +1 @@ -(()=>{"use strict";var e,a,t,r,d,c={},b={};function f(e){var a=b[e];if(void 0!==a)return a.exports;var t=b[e]={id:e,loaded:!1,exports:{}};return c[e].call(t.exports,t,t.exports,f),t.loaded=!0,t.exports}f.m=c,f.c=b,f.amdO={},e=[],f.O=(a,t,r,d)=>{if(!t){var c=1/0;for(i=0;i=d)&&Object.keys(f.O).every((e=>f.O[e](t[o])))?t.splice(o--,1):(b=!1,d0&&e[i-1][2]>d;i--)e[i]=e[i-1];e[i]=[t,r,d]},f.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return f.d(a,{a:a}),a},t=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,f.t=function(e,r){if(1&r&&(e=this(e)),8&r)return e;if("object"==typeof e&&e){if(4&r&&e.__esModule)return e;if(16&r&&"function"==typeof e.then)return e}var d=Object.create(null);f.r(d);var c={};a=a||[null,t({}),t([]),t(t)];for(var b=2&r&&e;"object"==typeof b&&!~a.indexOf(b);b=t(b))Object.getOwnPropertyNames(b).forEach((a=>c[a]=()=>e[a]));return c.default=()=>e,f.d(d,c),d},f.d=(e,a)=>{for(var t in a)f.o(a,t)&&!f.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:a[t]})},f.f={},f.e=e=>Promise.all(Object.keys(f.f).reduce(((a,t)=>(f.f[t](e,a),a)),[])),f.u=e=>"assets/js/"+({58:"0c66edb9",826:"47881d5c",1004:"c141421f",1360:"34e1d3b9",1387:"4555b262",1889:"339d500a",1975:"2c440c24",1999:"9af26a4e",2108:"288b1075",2732:"c015c796",2992:"f2348458",3182:"6e881e32",3629:"aba21aa0",3927:"20595907",4031:"ef8afbfd",4195:"c4f5d8e4",4196:"bbbe662c",4368:"a94703ab",4654:"4cb7be2f",4778:"e1dfe4fe",4838:"75b20590",4900:"600b2345",4920:"7452427d",5274:"e2c4d679",5327:"c304be44",5882:"d768dc0f",5889:"cda0d2e5",5893:"2da89d45",5980:"a7456010",6913:"b6569025",7076:"2e812224",7142:"1ba5bc99",7176:"6272ba0e",7273:"9939c4f4",7918:"17896441",7920:"1a4e3797",8156:"21880a4d",8198:"50ef9c44",8375:"4f1777fd",8518:"a7bd4aaa",8905:"07d0b302",8938:"f888b719",8945:"bc747cac",8993:"5cd0a723",9585:"11b43341",9661:"5e95c892",9817:"14eb3368"}[e]||e)+"."+{58:"cf3471cb",174:"592df3ab",826:"edcb5433",1004:"3e38baa4",1272:"43cc57fb",1360:"3769f1f9",1387:"e0e22fbe",1772:"ad1487e6",1889:"b74f3e5b",1975:"b75e9cbb",1999:"9abe8e9c",2108:"6c65bc93",2312:"2f123ece",2732:"c571777a",2992:"3093e5a9",3182:"29c415c5",3629:"b0420849",3927:"67ccb14e",4031:"af1b386c",4195:"ef51316b",4196:"953dbdf7",4368:"ccc909c6",4483:"af172fd7",4654:"a36a515f",4778:"79699f4b",4838:"636296cd",4900:"414376ef",4920:"e7e27721",5274:"2ab770e0",5327:"5b4bc2bb",5882:"5c5c9e16",5889:"72740dec",5893:"0235cd0f",5980:"37bc4934",6404:"ffcb2948",6913:"459556f5",6945:"8e8e2060",7076:"0ecf0f71",7142:"9c01a99c",7176:"b4fcb5f7",7273:"8ac98161",7918:"669126b4",7920:"3ac16762",8156:"be4f36fe",8198:"2dae98fd",8375:"3839c0bb",8518:"60d96043",8894:"46125374",8905:"568732d7",8938:"a58698f8",8945:"01a42caa",8993:"0b0c7f74",9585:"fa8647ec",9661:"4db699c3",9817:"1b8e95ef"}[e]+".js",f.miniCssF=e=>{},f.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),f.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),r={},d="website:",f.l=(e,a,t,c)=>{if(r[e])r[e].push(a);else{var b,o;if(void 0!==t)for(var n=document.getElementsByTagName("script"),i=0;i{b.onerror=b.onload=null,clearTimeout(s);var d=r[e];if(delete r[e],b.parentNode&&b.parentNode.removeChild(b),d&&d.forEach((e=>e(t))),a)return a(t)},s=setTimeout(l.bind(null,void 0,{type:"timeout",target:b}),12e4);b.onerror=l.bind(null,b.onerror),b.onload=l.bind(null,b.onload),o&&document.head.appendChild(b)}},f.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},f.p="/",f.gca=function(e){return e={17896441:"7918",20595907:"3927","0c66edb9":"58","47881d5c":"826",c141421f:"1004","34e1d3b9":"1360","4555b262":"1387","339d500a":"1889","2c440c24":"1975","9af26a4e":"1999","288b1075":"2108",c015c796:"2732",f2348458:"2992","6e881e32":"3182",aba21aa0:"3629",ef8afbfd:"4031",c4f5d8e4:"4195",bbbe662c:"4196",a94703ab:"4368","4cb7be2f":"4654",e1dfe4fe:"4778","75b20590":"4838","600b2345":"4900","7452427d":"4920",e2c4d679:"5274",c304be44:"5327",d768dc0f:"5882",cda0d2e5:"5889","2da89d45":"5893",a7456010:"5980",b6569025:"6913","2e812224":"7076","1ba5bc99":"7142","6272ba0e":"7176","9939c4f4":"7273","1a4e3797":"7920","21880a4d":"8156","50ef9c44":"8198","4f1777fd":"8375",a7bd4aaa:"8518","07d0b302":"8905",f888b719:"8938",bc747cac:"8945","5cd0a723":"8993","11b43341":"9585","5e95c892":"9661","14eb3368":"9817"}[e]||e,f.p+f.u(e)},(()=>{var e={1303:0,532:0};f.f.j=(a,t)=>{var r=f.o(e,a)?e[a]:void 0;if(0!==r)if(r)t.push(r[2]);else if(/^(1303|532)$/.test(a))e[a]=0;else{var d=new Promise(((t,d)=>r=e[a]=[t,d]));t.push(r[2]=d);var c=f.p+f.u(a),b=new Error;f.l(c,(t=>{if(f.o(e,a)&&(0!==(r=e[a])&&(e[a]=void 0),r)){var d=t&&("load"===t.type?"missing":t.type),c=t&&t.target&&t.target.src;b.message="Loading chunk "+a+" failed.\n("+d+": "+c+")",b.name="ChunkLoadError",b.type=d,b.request=c,r[1](b)}}),"chunk-"+a,a)}},f.O.j=a=>0===e[a];var a=(a,t)=>{var r,d,c=t[0],b=t[1],o=t[2],n=0;if(c.some((a=>0!==e[a]))){for(r in b)f.o(b,r)&&(f.m[r]=b[r]);if(o)var i=o(f)}for(a&&a(t);n{"use strict";var e,a,t,r,d,c={},b={};function f(e){var a=b[e];if(void 0!==a)return a.exports;var t=b[e]={id:e,loaded:!1,exports:{}};return c[e].call(t.exports,t,t.exports,f),t.loaded=!0,t.exports}f.m=c,f.c=b,f.amdO={},e=[],f.O=(a,t,r,d)=>{if(!t){var c=1/0;for(i=0;i=d)&&Object.keys(f.O).every((e=>f.O[e](t[o])))?t.splice(o--,1):(b=!1,d0&&e[i-1][2]>d;i--)e[i]=e[i-1];e[i]=[t,r,d]},f.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return f.d(a,{a:a}),a},t=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,f.t=function(e,r){if(1&r&&(e=this(e)),8&r)return e;if("object"==typeof e&&e){if(4&r&&e.__esModule)return e;if(16&r&&"function"==typeof e.then)return e}var d=Object.create(null);f.r(d);var c={};a=a||[null,t({}),t([]),t(t)];for(var b=2&r&&e;"object"==typeof b&&!~a.indexOf(b);b=t(b))Object.getOwnPropertyNames(b).forEach((a=>c[a]=()=>e[a]));return c.default=()=>e,f.d(d,c),d},f.d=(e,a)=>{for(var t in a)f.o(a,t)&&!f.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:a[t]})},f.f={},f.e=e=>Promise.all(Object.keys(f.f).reduce(((a,t)=>(f.f[t](e,a),a)),[])),f.u=e=>"assets/js/"+({58:"0c66edb9",826:"47881d5c",1004:"c141421f",1360:"34e1d3b9",1387:"4555b262",1889:"339d500a",1975:"2c440c24",1999:"9af26a4e",2108:"288b1075",2732:"c015c796",2992:"f2348458",3182:"6e881e32",3629:"aba21aa0",3927:"20595907",4031:"ef8afbfd",4195:"c4f5d8e4",4196:"bbbe662c",4368:"a94703ab",4654:"4cb7be2f",4778:"e1dfe4fe",4838:"75b20590",4900:"600b2345",4920:"7452427d",5274:"e2c4d679",5327:"c304be44",5882:"d768dc0f",5889:"cda0d2e5",5893:"2da89d45",5980:"a7456010",6913:"b6569025",7076:"2e812224",7142:"1ba5bc99",7176:"6272ba0e",7273:"9939c4f4",7918:"17896441",7920:"1a4e3797",8156:"21880a4d",8198:"50ef9c44",8375:"4f1777fd",8518:"a7bd4aaa",8905:"07d0b302",8938:"f888b719",8945:"bc747cac",8993:"5cd0a723",9585:"11b43341",9661:"5e95c892",9817:"14eb3368"}[e]||e)+"."+{58:"cf3471cb",174:"592df3ab",826:"edcb5433",1004:"3e38baa4",1272:"43cc57fb",1360:"3769f1f9",1387:"e0e22fbe",1772:"ad1487e6",1889:"b74f3e5b",1975:"b75e9cbb",1999:"9abe8e9c",2108:"6c65bc93",2312:"2f123ece",2732:"c571777a",2992:"3093e5a9",3182:"29c415c5",3629:"b0420849",3927:"67ccb14e",4031:"af1b386c",4195:"ef51316b",4196:"953dbdf7",4368:"ccc909c6",4483:"af172fd7",4654:"a36a515f",4778:"79699f4b",4838:"636296cd",4900:"414376ef",4920:"e7e27721",5274:"2ab770e0",5327:"5b4bc2bb",5882:"5c5c9e16",5889:"72740dec",5893:"0235cd0f",5980:"37bc4934",6404:"ffcb2948",6913:"459556f5",6945:"8e8e2060",7076:"0ecf0f71",7142:"9c01a99c",7176:"b3cbf92b",7273:"8ac98161",7918:"669126b4",7920:"3ac16762",8156:"be4f36fe",8198:"2dae98fd",8375:"3839c0bb",8518:"60d96043",8894:"46125374",8905:"568732d7",8938:"a58698f8",8945:"01a42caa",8993:"0b0c7f74",9585:"93b3652a",9661:"4db699c3",9817:"1b8e95ef"}[e]+".js",f.miniCssF=e=>{},f.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),f.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),r={},d="website:",f.l=(e,a,t,c)=>{if(r[e])r[e].push(a);else{var b,o;if(void 0!==t)for(var n=document.getElementsByTagName("script"),i=0;i{b.onerror=b.onload=null,clearTimeout(s);var d=r[e];if(delete r[e],b.parentNode&&b.parentNode.removeChild(b),d&&d.forEach((e=>e(t))),a)return a(t)},s=setTimeout(l.bind(null,void 0,{type:"timeout",target:b}),12e4);b.onerror=l.bind(null,b.onerror),b.onload=l.bind(null,b.onload),o&&document.head.appendChild(b)}},f.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},f.p="/",f.gca=function(e){return e={17896441:"7918",20595907:"3927","0c66edb9":"58","47881d5c":"826",c141421f:"1004","34e1d3b9":"1360","4555b262":"1387","339d500a":"1889","2c440c24":"1975","9af26a4e":"1999","288b1075":"2108",c015c796:"2732",f2348458:"2992","6e881e32":"3182",aba21aa0:"3629",ef8afbfd:"4031",c4f5d8e4:"4195",bbbe662c:"4196",a94703ab:"4368","4cb7be2f":"4654",e1dfe4fe:"4778","75b20590":"4838","600b2345":"4900","7452427d":"4920",e2c4d679:"5274",c304be44:"5327",d768dc0f:"5882",cda0d2e5:"5889","2da89d45":"5893",a7456010:"5980",b6569025:"6913","2e812224":"7076","1ba5bc99":"7142","6272ba0e":"7176","9939c4f4":"7273","1a4e3797":"7920","21880a4d":"8156","50ef9c44":"8198","4f1777fd":"8375",a7bd4aaa:"8518","07d0b302":"8905",f888b719:"8938",bc747cac:"8945","5cd0a723":"8993","11b43341":"9585","5e95c892":"9661","14eb3368":"9817"}[e]||e,f.p+f.u(e)},(()=>{var e={1303:0,532:0};f.f.j=(a,t)=>{var r=f.o(e,a)?e[a]:void 0;if(0!==r)if(r)t.push(r[2]);else if(/^(1303|532)$/.test(a))e[a]=0;else{var d=new Promise(((t,d)=>r=e[a]=[t,d]));t.push(r[2]=d);var c=f.p+f.u(a),b=new Error;f.l(c,(t=>{if(f.o(e,a)&&(0!==(r=e[a])&&(e[a]=void 0),r)){var d=t&&("load"===t.type?"missing":t.type),c=t&&t.target&&t.target.src;b.message="Loading chunk "+a+" failed.\n("+d+": "+c+")",b.name="ChunkLoadError",b.type=d,b.request=c,r[1](b)}}),"chunk-"+a,a)}},f.O.j=a=>0===e[a];var a=(a,t)=>{var r,d,c=t[0],b=t[1],o=t[2],n=0;if(c.some((a=>0!==e[a]))){for(r in b)f.o(b,r)&&(f.m[r]=b[r]);if(o)var i=o(f)}for(a&&a(t);n