1 files changed, 61 insertions, 0 deletions
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!