Update home authored by Lars Florian Meiendresch's avatar Lars Florian Meiendresch
...@@ -108,29 +108,30 @@ _We use Cloudflare for both CDN and caching functionalities on `19squared.de`, r ...@@ -108,29 +108,30 @@ _We use Cloudflare for both CDN and caching functionalities on `19squared.de`, r
Cloudflare Tunnels offer a cost-effective and secure way to deploy a 19squared instance. With this method, you simply run a server on your local machine (any laptop or PC). Then, a tunnel is established, allowing any internet-connected user to access the server running on your device. In this secure setup, your service communicates with a Cloudflare server, so users do not access the local machine directly. Cloudflare Tunnels offer a cost-effective and secure way to deploy a 19squared instance. With this method, you simply run a server on your local machine (any laptop or PC). Then, a tunnel is established, allowing any internet-connected user to access the server running on your device. In this secure setup, your service communicates with a Cloudflare server, so users do not access the local machine directly.
**Prerequisites:** **Prerequisites:**
1. Top-Level Domain: The domain's registration location is irrelevant. However, it will require configuration changes so that Cloudflare manages its DNS requests. This domain can also support other services after that. Domains are affordable, even as low as ~$5 per year on [Cloudflare Registrar](https://www.cloudflare.com/de-de/products/registrar/). 1. Top-Level Domain: The domain's registration location is irrelevant. However, it will require configuration changes so that Cloudflare manages its DNS requests. This domain can also support other services after that. Domains are affordable, even as low as ~$10 per year on [Cloudflare Registrar](https://www.cloudflare.com/de-de/products/registrar/).
2. Reasonably Modern Laptop or PC: No need for top-of-the-line hardware, just acceptable performance. If your device isn't ancient, it should suffice for small user groups. 2. Reasonably Modern Laptop or PC: No need for top-of-the-line hardware, just acceptable performance. If your device isn't ancient, it should suffice for small user groups.
**Learn More:** [Cloudflare Docs](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/) **Learn More:** [Cloudflare Docs](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/)
### Walkthrough Video ### Walkthrough Video
The following videos shows all steps needed to deploy the application using a Cloudflare tunnel. The following video shows all steps needed to deploy the application using a Cloudflare tunnel.
**Insert Video** [![Deploying 19squared on a Windows PC/Laptop with Cloudflare Tunnels](https://img.youtube.com/vi/R0P0X9kbPd4/0.jpg)](https://www.youtube.com/watch?v=R0P0X9kbPd4)
### Step-by-Step Guide ### Step-by-Step Guide
Perform the following steps on the machine you want to use as your server. Perform the following steps on the machine you want to use as your server.
1. [Install the Docker Engine](https://docs.docker.com/engine/install/) 1. [Create a Cloudflare Account](https://developers.cloudflare.com/fundamentals/setup/account/create-account/)
2. [Start 19squared](#production-server) 2. [Add the Domain to the Cloudflare Account](https://developers.cloudflare.com/fundamentals/setup/manage-domains/add-site/)
3. [Install the Docker Engine](https://docs.docker.com/engine/install/)
4. [Install git](https://git-scm.com/downloads)
5. [Start 19squared](#production-server)
- `git clone https://git.rwth-aachen.de/medialab/interactive360vr.git` - `git clone https://git.rwth-aachen.de/medialab/interactive360vr.git`
- `copy .env.template .env` - `copy .env.template .env`
- `docker compose up -d --build` - `docker compose up -d --build`
3. [Create a Cloudflare Account](https://developers.cloudflare.com/fundamentals/setup/account/create-account/) 6. [Create the Cloudflare Tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/get-started/create-remote-tunnel/)
4. [Add the Domain to the Cloudflare Account](https://developers.cloudflare.com/fundamentals/setup/manage-domains/add-site/)
5. [Create the Cloudflare Tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/get-started/create-remote-tunnel/)
- **Important:** Use Docker to install `cloudflare/cloudflared` and add `-d --network 19squared_frontend` between `docker run` and `cloudflare/cloudflared` of the provided command. - **Important:** Use Docker to install `cloudflare/cloudflared` and add `-d --network 19squared_frontend` between `docker run` and `cloudflare/cloudflared` of the provided command.
- **Service URL:** `http://19sq-nginx:80` - **Service URL:** `http://19sq-nginx:80`
... ...
......