From b8c6848dce2d168d88c39cc91608d9fccace7148 Mon Sep 17 00:00:00 2001 From: Roger Gonzalez Date: Sun, 22 Oct 2023 11:04:14 -0300 Subject: Added "common errors" page --- content/faqs/_index.md | 13 --------- content/faqs/common-errors.md | 61 +++++++++++++++++++++++++++++++++++++++++++ content/install/steps.md | 2 +- 3 files changed, 62 insertions(+), 14 deletions(-) create mode 100644 content/faqs/common-errors.md diff --git a/content/faqs/_index.md b/content/faqs/_index.md index 1ad46d5..99bb228 100644 --- a/content/faqs/_index.md +++ b/content/faqs/_index.md @@ -5,18 +5,6 @@ draft: false weight: 100 --- -## Common `docker` permission errors - -If you are getting errors like this when running the installer or running the `yams` cli: - -```sh -permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: -``` - -It might mean that you need to reload your user. This is fixed by logging out of your server and logging back in. - -This happens because your user needs to be part of the `docker` group in order to be able to execute `docker` without `sudo` - ## I don't want to configure YAMS manually, is there a pre-made configuration? Yes, but **I do not recommend using this option if this is the first time you configure YAMS.** You can check the instructions here: [Easy mode](/config/easy-mode). @@ -24,4 +12,3 @@ Yes, but **I do not recommend using this option if this is the first time you co ## Why did you choose instead of ? Because. That's why it's _**opinionated**_, you don't _necessarily_ have to agree with me. This setup is aimed at noobs and first time media server enthusiasts. You can always use my sources and fork the project 🔥 - diff --git a/content/faqs/common-errors.md b/content/faqs/common-errors.md new file mode 100644 index 0000000..f90b50b --- /dev/null +++ b/content/faqs/common-errors.md @@ -0,0 +1,61 @@ +--- +title: "Common issues" +date: 2023-10-22T10:22:29-03:00 +draft: false +weight: 1 +summary: How to fix common issues with YAMS. +--- + +# Docker + +## Common `docker` permission errors + +If you encounter errors like the one below when running the installer or the `yams` CLI: + +```sh +permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: +``` + +It might indicate that you need to refresh your user permissions. This issue can typically be resolved by logging out of your server and then logging back in. + +This problem arises because your user must be part of the `docker` group to execute `docker` commands without using `sudo`. + +# qBittorrent + +## qBittorrent has suddenly lost its internet connection + +Sometimes, Gluetun disconnects with no apparent reason. It usually comes back after a minute or so, but qBittorrent may not recover as expected. + +A helpful workaround is to create a cron job that monitors the status of qBittorrent and restarts it if necessary. + +To open your crontab, use the following command: `crontab -e` + +Now, paste the following line at the bottom: + +```bash +* * * * * /usr/bin/docker exec qbittorrent curl -s https://am.i.mullvad.net/connected || /usr/bin/docker restart qbittorrent +``` + +This script will check every minute whether qBittorrent has an internet connection. If it doesn't, the script will automatically restart it. + +## qBittorrent is not accessible + +If you [configured the VPN](/install/steps/#vpn), go to [Gluetun does not connect](#gluetun-does-not-connect) + +# Gluetun + +## Gluetun does not connect + +After installing YAMS, there are instances when Gluetun fails to connect, resulting in qBittorrent becoming inaccessible. + +To debug this issue, start by checking Gluetun's logs: + +```bash +docker logs -n 100 gluetun +``` + +This command will display the last 100 lines of the Gluetun logs. + +Many of the issues arise due to misconfigurations in your VPN setup. Please review the documentation for your VPN by clicking [here](/advanced/vpn). + +Review the logs to try and find a solution. If you require assistance, feel free to join our Matrix chat and ask for help! diff --git a/content/install/steps.md b/content/install/steps.md index 19ebb49..994c79f 100644 --- a/content/install/steps.md +++ b/content/install/steps.md @@ -44,7 +44,7 @@ Make sure you can run `docker` **without** `sudo`! If you run `docker` with `sudo` and another user other than `root` you'll encounter multiple permission errors. You can find instructions on how to run `docker` without `sudo` here: https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user. -If you can run `docker run hello-world` without `sudo`, you can continue. If you encounter any other `docker` issue, go to the [FAQs](/faqs/), there's a section on "Common `docker` permission errors". +If you can run `docker run hello-world` without `sudo`, you can continue. If you encounter any other `docker` issue, go here: [Common docker permission errors](/faqs/common-errors/#common-docker-permission-errors). ### Inspecting the `install` script by yourself (optional). -- cgit v1.2.3