zrok/assets/js/2e812224.cf9aefef.js

"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[76],{4695:(e,r,o)=>{o.r(r),o.d(r,{assets:()=>c,contentTitle:()=>t,default:()=>d,frontMatter:()=>s,metadata:()=>a,toc:()=>l});var n=o(5893),i=o(1151);const s={title:"Docker Public Share",sidebar_position:10,sidebar_label:"Public Share"},t=void 0,a={id:"guides/docker-share/docker_public_share_guide",title:"Docker Public Share",description:"With zrok and Docker, you can publicly share a web server that's running in a local container or anywhere that's reachable by the zrok container. The share can be reached through a temporary public URL that expires when the container is stopped. If you're looking for a reserved subdomain for the share, check out zrok frontdoor.",source:"@site/../docs/guides/docker-share/docker_public_share_guide.md",sourceDirName:"guides/docker-share",slug:"/guides/docker-share/docker_public_share_guide",permalink:"/docs/guides/docker-share/docker_public_share_guide",draft:!1,unlisted:!1,editUrl:"https://github.com/openziti/zrok/blob/main/docs/../docs/guides/docker-share/docker_public_share_guide.md",tags:[],version:"current",sidebarPosition:10,frontMatter:{title:"Docker Public Share",sidebar_position:10,sidebar_label:"Public Share"},sidebar:"tutorialSidebar",previous:{title:"Docker Share",permalink:"/docs/category/docker-share"},next:{title:"Private Share",permalink:"/docs/guides/docker-share/docker_private_share_guide"}},c={},l=[{value:"Walkthrough Video",id:"walkthrough-video",level:2},{value:"Before You Begin",id:"before-you-begin",level:2},{value:"Begin Sharing with Docker Compose",id:"begin-sharing-with-docker-compose",level:2},{value:"Proxy Any Web Server",id:"proxy-any-web-server",level:2},{value:"Require Authentication",id:"require-authentication",level:2},{value:"Customize Temporary Public Share",id:"customize-temporary-public-share",level:2},{value:"Destroy the zrok Environment",id:"destroy-the-zrok-environment",level:2}];function h(e){const r={a:"a",code:"code",h2:"h2",li:"li",ol:"ol",p:"p",pre:"pre",...(0,i.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsxs)(r.p,{children:["With zrok and Docker, you can publicly share a web server that's running in a local container or anywhere that's reachable by the zrok container. The share can be reached through a temporary public URL that expires when the container is stopped. If you're looking for a reserved subdomain for the share, check out ",(0,n.jsx)(r.a,{href:"/docs/guides/frontdoor",children:"zrok frontdoor"}),"."]}),"\n",(0,n.jsxs)(r.p,{children:["Here's a short article with an overview of ",(0,n.jsx)(r.a,{href:"/docs/concepts/sharing-public",children:"public sharing with zrok"}),"."]}),"\n",(0,n.jsx)(r.h2,{id:"walkthrough-video",children:"Walkthrough Video"}),"\n",(0,n.jsx)("iframe",{width:"100%",height:"315",src:"https://www.youtube.com/embed/ycov--9ZtB4",title:"YouTube video player",frameborder:"0",allow:"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share",allowfullscreen:!0}),"\n",(0,n.jsx)(r.h2,{id:"before-you-begin",children:"Before You Begin"}),"\n",(0,n.jsxs)(r.p,{children:["To follow this guide you will need ",(0,n.jsx)(r.a,{href:"https://docs.docker.com/get-docker/",children:"Docker"})," and ",(0,n.jsx)(r.a,{href:"https://docs.docker.com/compose/install/",children:"the Docker Compose plugin"})," for running ",(0,n.jsx)(r.code,{children:"docker compose"})," commands in your terminal."]}),"\n",(0,n.jsx)(r.h2,{id:"begin-sharing-with-docker-compose",children:"Begin Sharing with Docker Compose"}),"\n",(0,n.jsx)(r.p,{children:"A temporary public share is a great way to share a web server running in a container with someone else for a short time."}),"\n",(0,n.jsxs)(r.ol,{children:["\n",(0,n.jsx)(r.li,{children:"Make a folder on your computer to use as a Docker Compose project for your zrok public share."}),"\n",(0,n.jsx)(r.li,{children:"In your terminal, change directory to the newly-created project folder."}),"\n",(0,n.jsxs)(r.li,{children:["Download ",(0,n.jsx)(r.a,{href:"pathname:///zrok-public-s