diff --git a/docs/.Navigation.md.kate-swp b/docs/.Navigation.md.kate-swp new file mode 100644 index 00000000..4e01b1e7 Binary files /dev/null and b/docs/.Navigation.md.kate-swp differ diff --git a/docs/Navigation.md b/docs/Navigation.md index 5b580a59..962eeeee 100644 --- a/docs/Navigation.md +++ b/docs/Navigation.md @@ -22,7 +22,8 @@ search: - [RuffleRS](Platforms-and-Players/RuffleRS-Player.md) - [Custom Platforms](Platforms-and-Players/Custom-Platforms.md) - System Setup Guides - - [Unraid Setup](System-Setup/Unraid-Setup-Guide.md) + - [Unraid](System-Setup/Unraid-Setup-Guide.md) + - [With Docker Compose](System-Setup/Unraid-Compose-Setup.md) - [Synology Setup](System-Setup/Synology-Setup-Guide.md) - [TrueNAS Setup](System-Setup/TrueNAS-Setup-Guide.md) - OIDC Setup Guides diff --git a/docs/OIDC-Guides/.OIDC-Setup-With-PocketID.md.kate-swp b/docs/OIDC-Guides/.OIDC-Setup-With-PocketID.md.kate-swp new file mode 100644 index 00000000..dd2d7311 Binary files /dev/null and b/docs/OIDC-Guides/.OIDC-Setup-With-PocketID.md.kate-swp differ diff --git a/docs/System-Setup/.Unraid-Setup-Guide.md.kate-swp b/docs/System-Setup/.Unraid-Setup-Guide.md.kate-swp new file mode 100644 index 00000000..16008abd Binary files /dev/null and b/docs/System-Setup/.Unraid-Setup-Guide.md.kate-swp differ diff --git a/docs/System-Setup/Unraid-Compose-Setup.md b/docs/System-Setup/Unraid-Compose-Setup.md new file mode 100644 index 00000000..de01e58c --- /dev/null +++ b/docs/System-Setup/Unraid-Compose-Setup.md @@ -0,0 +1,61 @@ + + +## Prerequisites + +Before getting started, install the [Community Apps plugin](https://forums.unraid.net/topic/38582-plug-in-community-applications/) for Unraid. + +Install [Docker Compose Addon](https://forums.unraid.net/topic/114415-plugin-docker-compose-manager/) from the CA (Community Apps Store) + +![Docker Compose Addon](../resources/unraid/docker-compose.png) + +### Docker Tab + +You will now see Compose option under the Docker Containers in your Docker Tab in Unraid + +![Docker Compose Section](../resources/unraid/unraid-start.png) + +## Installation + +Click **Add New Stack** + +- Name it **RomM** and click **OK** + +- Click the **Gear Icon**, edit stack, then edit the compose file + +![Edit Stack](../resources/unraid/edit-stack.png) + +- Add in the example Docker Compose from our [example docker-compose.yml](https://github.com/rommapp/romm/blob/release/examples/docker-compose.example.yml) + +- Add your environment variables, for example: API keys, MariaDB info, and metadata providers + + - You can use secrets and fill in information in a separate `.env` file + +![Edit Compose](../resources/unraid/unraid-compose.png) + +- Click the **Gear Icon**, edit stack, then edit the environment file + + - Fill in any environment variables if you used secrets, etc. + +- Make sure to click **Save Changes** after each edit to the compose and environment files + +![Edit Env](../resources/unraid/romm-env.png) + + +!!! warning + You need to make sure you are following either Folder Structure A or B (Recommend A Type) [RomM Folder Structure](https://docs.romm.app/latest/Getting-Started/Folder-Structure/) + + +!!! warning + It's strongly recommended to backup the `appdata` folder (or mount it in a safe location) before updating, since tearing down the container will wipe the resources (covers, screenshots, etc.) + +## Finish + +- Click Compose Up + +![Compose Up Working](../resources/unraid/docker-compose-loading.png) + +Grab `IP:Port` from romm, and open tab in browser in `http://IP:Port` and it should take you to setup screen + +![Compose Up](../resources/unraid/docker-compose-up.png) + +![Romm Setup](../resources/unraid/unraid-success.png) diff --git a/docs/resources/unraid/docker-compose-loading.png b/docs/resources/unraid/docker-compose-loading.png new file mode 100644 index 00000000..459994b4 Binary files /dev/null and b/docs/resources/unraid/docker-compose-loading.png differ diff --git a/docs/resources/unraid/docker-compose-up.png b/docs/resources/unraid/docker-compose-up.png new file mode 100644 index 00000000..503b7557 Binary files /dev/null and b/docs/resources/unraid/docker-compose-up.png differ diff --git a/docs/resources/unraid/docker-compose.png b/docs/resources/unraid/docker-compose.png new file mode 100644 index 00000000..36de1466 Binary files /dev/null and b/docs/resources/unraid/docker-compose.png differ diff --git a/docs/resources/unraid/edit-stack.png b/docs/resources/unraid/edit-stack.png new file mode 100644 index 00000000..7b1e9518 Binary files /dev/null and b/docs/resources/unraid/edit-stack.png differ diff --git a/docs/resources/unraid/romm-env.png b/docs/resources/unraid/romm-env.png new file mode 100644 index 00000000..8a194886 Binary files /dev/null and b/docs/resources/unraid/romm-env.png differ diff --git a/docs/resources/unraid/unraid-compose.png b/docs/resources/unraid/unraid-compose.png new file mode 100644 index 00000000..e2a0317c Binary files /dev/null and b/docs/resources/unraid/unraid-compose.png differ diff --git a/docs/resources/unraid/unraid-start.png b/docs/resources/unraid/unraid-start.png new file mode 100644 index 00000000..a8eb5b09 Binary files /dev/null and b/docs/resources/unraid/unraid-start.png differ diff --git a/docs/resources/unraid/unraid-success.png b/docs/resources/unraid/unraid-success.png new file mode 100644 index 00000000..b0129bec Binary files /dev/null and b/docs/resources/unraid/unraid-success.png differ