From 3de1734a4bda9300bd0d7daa508c3b276162d6cc Mon Sep 17 00:00:00 2001 From: Roger Gonzalez Date: Sat, 21 Oct 2023 22:00:56 -0300 Subject: Added "adding your own containers" documentation --- content/advanced/add-your-own-containers.md | 72 +++++++++++++++++++++++++++++ content/advanced/backups.md | 2 +- content/advanced/lidarr.md | 2 +- content/advanced/portainer.md | 2 +- content/advanced/readarr.md | 2 +- content/advanced/torrenting.md | 2 +- content/advanced/vpn.md | 2 +- 7 files changed, 78 insertions(+), 6 deletions(-) create mode 100644 content/advanced/add-your-own-containers.md diff --git a/content/advanced/add-your-own-containers.md b/content/advanced/add-your-own-containers.md new file mode 100644 index 0000000..d59c412 --- /dev/null +++ b/content/advanced/add-your-own-containers.md @@ -0,0 +1,72 @@ +--- +title: "Adding your own containers to YAMS" +date: 2023-10-21T21:41:29-03:00 +draft: false +weight: 1 +summary: Instructions on how to add your own Docker containers to YAMS. +--- + +Adding your own containers in YAMS is very easy. + +First, go to your install location. For the purposes of this tutorial, I'll use `/opt/yams`. + +```bash +cd /opt/yams +``` + +If you `ls`, you'll see 2 files: +- `docker-compose.yaml`: This is YAMS. You shouldn't mess with this file manually. +- `docker-compose.custom.yaml`: Here's where you'll add your containers. Any container you add here will be automatically added to the YAMS network and will be able to communicate locally with YAMS. + +To add your containers, you'll have a few environment variables available: + +- `PUID`: Your PUID. +- `PGID`: Your PGID. +- `MEDIA_DIRECTORY`: Your media directory. +- `INSTALL_LOCATION`: Your install location. + +# Adding a container + +As an example, I'll add [Overseerr](https://overseerr.dev/). + +Open `docker-compose.custom.yaml` and add the following information: + +```yaml +version: "3" + +services: # -> Uncomment this line! (remove the "#" in front of it) + +# Add your container here 👇 + overseerr: + image: lscr.io/linuxserver/overseerr:latest + container_name: overseerr + environment: + - PUID=${PUID} # Note how I'm using the env variables here + - PGID=${PGID} # Note how I'm using the env variables here + volumes: + - ${INSTALL_LOCATION}/config/overseer:/config # Note how I'm using the env variables here + ports: + - 5055:5055 + restart: unless-stopped +``` + +To start the container, run: + +```bash +yams restart +``` + +If everything is okay, you should see Overseer installing: + +```bash + ⠙ overseerr Pulling 5.2s + + + ... +``` + +And that's it! + +You can find new containers here: +- https://fleet.linuxserver.io/ (recommended). +- https://hub.docker.com/. diff --git a/content/advanced/backups.md b/content/advanced/backups.md index 3425d24..13293ee 100644 --- a/content/advanced/backups.md +++ b/content/advanced/backups.md @@ -2,7 +2,7 @@ title: "Backups" date: 2023-01-17T19:38:39-03:00 draft: false -weight: 3 +weight: 4 summary: Backup your YAMS configuration. --- diff --git a/content/advanced/lidarr.md b/content/advanced/lidarr.md index 3099457..65231f1 100644 --- a/content/advanced/lidarr.md +++ b/content/advanced/lidarr.md @@ -2,7 +2,7 @@ title: "Lidarr" date: 2023-01-31T11:20:14-03:00 draft: false -weight: 5 +weight: 6 summary: Lidarr is a music collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new albums from your favorite artists and will interface with clients and indexers to grab, sort, and rename them. It can also be configured to automatically upgrade the quality of existing files in the library when a better quality format becomes available. --- diff --git a/content/advanced/portainer.md b/content/advanced/portainer.md index 84f2674..9704124 100644 --- a/content/advanced/portainer.md +++ b/content/advanced/portainer.md @@ -2,7 +2,7 @@ title: "Portainer" date: 2023-01-30T15:46:05-03:00 draft: false -weight: 4 +weight: 5 summary: Deploy, configure, troubleshoot and secure containers in minutes on Kubernetes, Docker, Swarm and Nomad in any data center, cloud, network edge or IIOT device. --- diff --git a/content/advanced/readarr.md b/content/advanced/readarr.md index fef1ee5..851c03e 100644 --- a/content/advanced/readarr.md +++ b/content/advanced/readarr.md @@ -2,7 +2,7 @@ title: "Readarr" date: 2023-01-31T13:52:34-03:00 draft: false -weight: 6 +weight: 7 summary: Readarr is a ebook collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new books from your favorite authors and will interface with clients and indexers to grab, sort, and rename them. --- diff --git a/content/advanced/torrenting.md b/content/advanced/torrenting.md index b5a649f..daa4989 100644 --- a/content/advanced/torrenting.md +++ b/content/advanced/torrenting.md @@ -2,7 +2,7 @@ title: "Torrenting" date: 2023-01-16T14:48:14-03:00 draft: false -weight: 2 +weight: 3 summary: Advanced torreting advices. --- diff --git a/content/advanced/vpn.md b/content/advanced/vpn.md index cc39845..8b88945 100644 --- a/content/advanced/vpn.md +++ b/content/advanced/vpn.md @@ -2,7 +2,7 @@ title: "VPN" date: 2023-01-15T21:16:29-03:00 draft: false -weight: 1 +weight: 2 summary: Advanced configuration for the VPN, supported VPN lists and manual configuration. --- -- cgit v1.2.3