Documentation for Nestri (#116)

I have made documentation for Nestri, so everybody easy can find
instructions to get started. It will also make it easier for people to
help contribute to the documentation.

The documentation is built with Nuxt3, [Docus
](https://github.com/nuxt-themes) which uses Nuxt Content.

![image](https://github.com/user-attachments/assets/b30258c3-2267-4710-b8f4-48145e7c98d0)

![image](https://github.com/user-attachments/assets/6ccad52e-b6e1-4c8d-9c0c-bc4fae0227f1)

apps/docs/content/0.index.md

@@ -0,0 +1,48 @@
+---
+title: Home
+navigation: false
+layout: page
+main:
+  fluid: false
+---
+
+:ellipsis{right=0px width=75% blur=150px}
+
+::block-hero
+---
+cta:
+  - Get started
+  - /introduction/what-is-nestri
+  
+secondary:
+  - Open on GitHub →
+  - https://github.com/nestriness/nestri
+---
+
+#title
+An open-source, self-hosted Geforce Now alternative.
+
+#description
+Play your favorite games on the go or with your friends on your own game cloud.
+
+#extra
+  ::list
+  - **Selfhosted** cloud gaming
+  - **Open Source** and **Free**
+  - 1.5k ⭐️ on GitHub
+
+
+  ::
+
+<!--#support
+  ::terminal
+  ---
+  content:
+  - npx nuxi@latest init -t themes/docus
+  - cd docs
+  - npm install
+  - npm run dev
+  ---
+  ::-->
+::
+

apps/docs/content/1.introduction/1.what-is-nestri.md

@@ -0,0 +1,19 @@
+# What is Nestri?
+
+Nestri is a self-hosted cloud-gaming solution that allows you to stream and play your own games remotely from any device with a browser. Similar to services like NVIDIA GeForce Now, Nestri lets you enjoy high-performance gaming without being physically tied to your gaming PC. The key difference is that Nestri is entirely self-hosted, meaning you have complete control over the server, the games you install, and the overall setup.
+
+Nestri is designed for gamers who value privacy, flexibility, and control, making it the ideal choice for those who prefer to manage their own infrastructure rather than rely on third-party services. You can play your games from virtually anywhere, as long as you have access to a web browser and a stable internet connection.
+## Nestri Modules
+
+To provide a smooth and efficient gaming experience, Nestri is composed of the following key components:
+
+### Nestri Node
+The Nestri Node is the core of your Nestri setup. It acts as the game server where you install and run your games. The Nestri Node streams gameplay from the machine it’s installed on, allowing you to access your games remotely. It runs on most Linux-based systems and requires an NVIDIA graphics card to ensure a high-quality gaming experience.
+
+Since Nestri Node cannot run alongside Xorg (the graphical interface), it’s recommended to install it on a dedicated machine. This way, your server can focus solely on streaming your games while avoiding conflicts with your local display setup.
+
+### Nestri Relay
+The Nestri Relay is responsible for transporting the video stream from your Nestri Node to the device you're gaming on. By default, Nestri connects to the Nestri-hosted Relay, which requires no configuration and is available for all users. This simplifies the setup process, ensuring a smooth streaming experience without the need for advanced networking or SSL certificate management.
+
+For advanced users, it's possible to self-host the relay, but this requires the setup of secure SSL certificates. This option is typically more complex and is recommended only for developers or those familiar with network configuration.
+

apps/docs/content/1.introduction/_dir.yml

@@ -0,0 +1,2 @@
+icon: ph:star-duotone
+navigation.redirect: /introduction/what-is-nestri

apps/docs/content/2.nestri-node/1.what-is-nestri-node.md

@@ -0,0 +1,9 @@
+# What is Nestri Node?
+
+Nestri Node is the core component of Nestri's self-hosted cloud-gaming solution, designed for users who want the freedom and flexibility of running their own game-streaming server. Similar to services like NVIDIA GeForce Now, Nestri allows you to play your games remotely via your browser. However, unlike other cloud-gaming platforms, Nestri is fully self-hosted, giving you complete control over your server and gaming experience.
+
+The Nestri Node is the actual server where you install your games. Once set up, you can stream and play your games remotely from any compatible device. It runs on machines with Linux and requires an NVIDIA, AMD or an Intel graphics card .
+## ⚠️ Important Note
+
+We recommend not installing Nestri Node on your primary PC if you only intend to use it over a weekend. This is because Nestri Node cannot run simultaneously with Xorg, the display server responsible for managing the graphical user interface (GUI). This means that while Nestri Node is running, you will not be able to use an attached screen. For this reason, Nestri Node is best set up on a dedicated machine that won’t be used for other tasks.
+

apps/docs/content/2.nestri-node/2.prerequisite.md

@@ -0,0 +1,51 @@
+# Prerequisite
+
+In order to run Nestri on your own server, there are a few things you need to prepare before you can start installing nestri-node. On this page we go through the requirements needed to get started with Nestri.
+
+Although it may be very tempting to skip this step, you shouldn't! You will save yourself a lot of headaches and wasted hours because something doesn't work due to lack of setup beforehand.
+
+## Hardware Requirements
+
+::list{type="primary"}
+- **NVIDIA GPU**
+- **8GB Memory**
+- **Linux** (We Recommend Ubuntu Desktop 22.04)
+::
+
+## Software Requirements
+
+::list{type="primary"}
+- **Nvidia Drivers**
+- **[NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html#installing-with-apt)**
+- **[Docker](https://linuxiac.com/how-to-install-docker-on-ubuntu-24-04-lts/)**
+
+::
+
+## Disconnect monitor
+Since Nestri requires access to your GPU, then you need to unplug you screen from it.
+If you want to see the Desktop and have a integrated graphicscard in your CPU, then you can connect your monitor to the motherboard.
+### Change the Default Boot Target to Multi-User (Non-GUI Mode)
+Ubuntu typically starts in graphical mode (using the graphical.target systemd target). You should change to the non-graphical multi-user.target, which will prevent Xorg from starting.
+
+1. Open a terminal or access your system via SSH.
+2. To check your current default target (which should be graphical.target)
+
+```bash
+systemctl get-default
+
+```
+
+3. Change the default target to multi-user.target (which corresponds to text mode, without Xorg):
+```bash
+sudo systemctl set-default multi-user.target
+
+
+```
+
+4. Reboot the system
+
+5. Verify that Xorg is not running
+```bash
+nvidia-smi
+```
+

apps/docs/content/2.nestri-node/3.getting-started.md

@@ -0,0 +1,30 @@
+# Getting Started
+
+::alert{type="danger"}
+Nestri is in a **very early-beta phase**, so errors and bugs may occur.
+::
+<!--
+Nestri Node is easy to install using the provided installation script. Follow the steps below to get started.
+
+ ## Installation
+
+1. Download the installation script using `wget`:
+
+```bash
+wget https://github.com/nestriness/nestri/nestri-node-install.sh
+
+```
+
+2. Make the script executable:
+```bash
+chmod +x nestri-node-install.sh
+
+
+```
+3. Run the script to start the installation process:
+```bash
+./nestri-node-install.sh
+```
+::-->
+
+

apps/docs/content/2.nestri-node/4.troubleshooting.md

@@ -0,0 +1,2 @@
+# Troubleshooting
+

apps/docs/content/2.nestri-node/_dir.yml

@@ -0,0 +1,2 @@
+title: 'Nestri Node'
+icon: heroicons-outline:bookmark-alt

apps/docs/content/3.nestri-relay/1.what-is-nestri-node.md

@@ -0,0 +1,9 @@
+# What is Nestri Relay?
+
+Nestri Relay is an essential component in the Nestri cloud-gaming ecosystem, responsible for transporting the video gameplay stream from your Nestri Node to the device you’re playing on. It is built on the moq-rs protocol, designed for efficient and smooth video transmission, ensuring a low-latency gaming experience.
+
+By default, your Nestri Node will connect to the Nestri-hosted Relay, which we manage and is available for all users. This is the simplest and most straightforward option, requiring no additional configuration on your end.
+## ⚠️ Important Note
+
+We recommend not installing Nestri Node on your primary PC if you only intend to use it over a weekend. This is because Nestri Node cannot run simultaneously with Xorg, the display server responsible for managing the graphical user interface (GUI). This means that while Nestri Node is running, you will not be able to use an attached screen. For this reason, Nestri Node is best set up on a dedicated machine that won’t be used for other tasks.
+

apps/docs/content/3.nestri-relay/2.selfhosted-nestri-relay.md

@@ -0,0 +1,25 @@
+## Self-hosted Nestri Relay
+
+For those who prefer full control over their infrastructure, it is possible to self-host the Nestri Relay. However, setting this up can be a bit complex, as it requires generating SSL certificates for secure communication between your Nestri Node and your gaming devices. There are three main options:
+
+- **Let's Encrypt Certificate**: This is the **recommended option** for self-hosting and requires a domain name. You can generate a certificate using tools like **certbot** or **acme.sh**. Let's Encrypt provides free SSL certificates that are trusted by most browsers and are relatively straightforward to set up.
+
+- **Purchased SSL Certificate**: The **easiest option** for most users is to buy an SSL certificate from a trusted Certificate Authority (CA). This option eliminates much of the hassle involved with certificate generation, as these certificates are already trusted by browsers and don’t require as much manual setup.
+
+While self-hosting offers more flexibility, most users will find the **Nestri-hosted Relay** to be the easiest and most reliable option for getting started with cloud gaming on Nestri. This hosted relay is available to everyone and requires no configuration.
+
+---
+
+## Prerequisites
+
+1. **Server Requirements:**
+   - Ensure **port 443** is open for both **TCP and UDP** (`:443/udp & :443/tcp`).
+   - The server should have at least **4GB RAM** and **2 vCPUs**.
+   - Supports both ARM or AMD64 architecture.
+
+2. **Software Requirements:**
+   - Docker and `docker-compose` must be installed on the server. You can use [this installation script](https://github.com/docker/docker-install) to set up Docker.
+   - Git must be installed to clone the necessary repository.
+
+3. **Certificates:**
+   - You will need both private and public SSL certificates. It is recommended to use certificates from a **trusted Certificate Authority** (CA), either by using **Let's Encrypt** or purchasing a commercial SSL certificate, for secure communication. Avoid using self-signed certificates, as they can lead to compatibility issues and security warnings in browsers.

apps/docs/content/3.nestri-relay/3.deploy-moq.md

@@ -0,0 +1,69 @@
+## Installation Steps
+
+### Step 1: Clone the Repository
+
+Clone the `kixelated/moq-rs` repository to your local machine:
+
+```bash
+git clone https://github.com/kixelated/moq-rs moq
+```
+
+### Step 2: Verify Port Availability
+
+Check if port 443 is already in use on your server:
+
+```bash
+sudo netstat -tulpn | grep ':443' | grep LISTEN
+```
+or
+```bash
+sudo lsof -i -P -n | grep LISTEN | grep 443
+```
+
+If you find any processes using port 443, consider terminating them.
+
+### Step 3: Configure Ports
+
+Navigate to the cloned directory and edit the Docker compose file to use port 443:
+
+```bash
+cd moq
+vim docker-compose.yml
+```
+
+Change the ports section from lines 34 to 35 to:
+
+```yaml
+ports:
+  - "443:443"
+  - "443:443/udp"
+```
+
+### Step 4: Prepare Certificates
+
+Copy your generated certificates into the `moq/dev` directory and rename them:
+
+```bash
+cp cert.pem moq/dev/localhost.crt
+cp key.pem moq/dev/localhost.key
+```
+
+### Step 5: Start Docker Instances
+
+Ensure you are in the root directory of the `moq` project, then start the Docker containers:
+
+```bash
+docker compose up -d
+```
+
+### Step 6: Link Domain to Server IP
+
+Configure your DNS settings to connect your server's IP address to your domain:
+
+```
+Record Type: A
+Subdomain: relay.fst.so
+IP Address: xx.xxx.xx.xxx
+```
+
+Congratulations, your MoQ server is now set up! You can verify its functionality by using the [MoQ Checker](https://nestri.pages.dev/moq/checker).

apps/docs/content/3.nestri-relay/4.advanced-users.md

@@ -0,0 +1,42 @@
+# ⚠️ Advanced users
+
+## Generating an SSL Certificate for Nestri Relay
+
+This guide is for developers and advanced users who wish to self-host Nestri Relay. We strongly discourage this setup for general users due to its complexity, particularly when it comes to configuring SSL certificates correctly. Using a self-signed certificate or manually generating certificates can lead to issues with browser compatibility and security warnings, making it difficult to ensure a smooth experience.
+
+For most users, we highly recommend using the **Nestri-hosted Relay**, which requires no manual setup and is ready to use out of the box.
+
+---
+
+## Generating an SSL Certificate Using Terraform
+
+If you still wish to proceed with self-hosting, we recommend using Terraform to generate a valid SSL certificate. This method provides a secure, automated way to obtain the necessary certificates for Nestri Relay.
+
+### Usage
+
+1. **Update the `terraform.tfvars`** file with your domain and email.
+2. Run the following command to initialize the Terraform working directory:
+   
+   ```bash
+   terraform init
+   ```
+   ```bash
+   terraform plan
+   ```
+   ```bash
+   terraform apply
+   ```
+The configuration provides two sensitive outputs:
+```bash
+certificate_pem: The full certificate chain
+private_key_pem: The private key for the certificate
+```
+
+These can be then be used in your `moq-relay` as it requires SSL/TLS certificates.
+
+## Note
+The generated certificate and key files are saved locally and ignored by git:
+```git
+.terraform
+relay_*
+```

apps/docs/content/3.nestri-relay/5.moq-tester.md

@@ -0,0 +1,4 @@
+## MOQ Tester
+Test your Nestri Relay, with our MOQ tester tool.
+
+:button-link[Try MOQ Test Tool]{size="small" icon="IconStackBlitz" href="https://nestri.pages.dev/moq/checker" blank}

apps/docs/content/3.nestri-relay/_dir.yml

@@ -0,0 +1,2 @@
+title: 'Nestri Relay'
+icon: heroicons-outline:bookmark-alt