From e7bb0f2aca97f4e863faa54c8bb41ecf8c0ed133 Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sat, 9 May 2020 23:17:46 +0000 Subject: [PATCH 01/10] Adding quota words o dictionary --- .vscode/settings.json | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.vscode/settings.json b/.vscode/settings.json index cf5e0e9e..0ca8f4e8 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -50,6 +50,8 @@ "rutorrent", "sabnzbd", "scgi", + "setdisk", + "setquota", "sharedserver", "shellinabox", "sickchill", From cec6c5bd77dec86bb32426e30af11f1093536b3a Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sat, 9 May 2020 23:20:03 +0000 Subject: [PATCH 02/10] Add setquota page --- docs/scripts/setquota.md | 38 ++++++++++++++++++++++++++++++++++++++ website/sidebars.json | 3 +++ 2 files changed, 41 insertions(+) create mode 100644 docs/scripts/setquota.md diff --git a/docs/scripts/setquota.md b/docs/scripts/setquota.md new file mode 100644 index 00000000..4926497c --- /dev/null +++ b/docs/scripts/setquota.md @@ -0,0 +1,38 @@ +--- +id: setquota +title: setquota +sidebar_label: setquota +--- + +This script helps setting quotas to users in an easy manner. + +It is run during the `box adduser` command as well. + +By default, the master user does not have a quota set which can result in odd UI behavior. You can use this command to rectify such issues. Please consider if you truly need the quota functionality if you are the sole user of a machine. + +## Format for the size. + +You can specify the format in one of the following formats: +- Specific size + - Available units are MBs, GBs and TBs. + - This format does not allow for decimals, therefore only `12GB`, `123456MB` or etc. will work; not `12.3GB`, `1.45TB` etc. +- Maximum + - This will retrieve the disk that quotas are set on, and set the maximum. + - **Please note the following caveats**: + - This size can be slightly larger than what the disk can actually store due to how partitioning works. + - The "Available" is purely a subtraction of the user's used space minus the quota, therefore it does not take into account space used by anything else other than the user. + +## Running interactively + +You can run `sudo setquota` and specify the user and size interactively on the command line. + +## Running with parameters + +`setquota` also runs non-interactively. You can set the user as the first argument, and the size as described above as an optional second argument. + +```bash +#Set size interactively +sudo setdisk user1 +#Set size as parameter +sudo setdisk user1 20GB +``` \ No newline at end of file diff --git a/website/sidebars.json b/website/sidebars.json index f966cd42..b012f6ce 100644 --- a/website/sidebars.json +++ b/website/sidebars.json @@ -55,6 +55,9 @@ ], "Guides": [ "guides/dist-upgrade" + ], + "Helper Scripts":[ + "scripts/setquota", ] } } From f7bdaa572633422de7473622e5cd4cc1f6c199d5 Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sat, 9 May 2020 23:20:11 +0000 Subject: [PATCH 03/10] Add Quota page --- docs/applications/quota.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 docs/applications/quota.md diff --git a/docs/applications/quota.md b/docs/applications/quota.md new file mode 100644 index 00000000..92faa7da --- /dev/null +++ b/docs/applications/quota.md @@ -0,0 +1,28 @@ +--- +id: quota +title: Quota +sidebar_label: Quota +--- +This application installs the necessary dependencies to use the Quota system. + +An administrator can use this utility to restrict how much disk space can each user fill, using a soft and a hard limit. + +## Installation + +You can install the quota application by running the following command. + +```bash +box install quota +``` + +## Setup + +As part of the installation you will be asked which drive to use fo the quota functionality. This is due to the fact that quota works on a per-disk basis. + +If you are unsure which partition to use, please refer to the help printed into the terminal during the installation. + +## Management + +The quotas can be managed either using the (Webmin application)[webmin.md], or through the command line using the (setquota)[setquota.md] script. + +All users can see their quota standing by running `quota -s`. \ No newline at end of file From 70d2c23bf7b500c877caf7c0e2bb90b70718c540 Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sat, 9 May 2020 23:20:34 +0000 Subject: [PATCH 04/10] Make links from FAQ and add rutorrent mention because I've seen that at least 3 times now. --- docs/getting-started/faqs.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/getting-started/faqs.md b/docs/getting-started/faqs.md index 613a6a0d..3321400e 100644 --- a/docs/getting-started/faqs.md +++ b/docs/getting-started/faqs.md @@ -40,7 +40,11 @@ It's unlikely that the partiton on *your* server is sda3, so you'll need to use ## The dashboard states I have 0 out of 0 remaining disk space. What's going on? -Did you install the `quota` package? You need to use the command `setquota` to define the limits per user. The default is undefined. +Did you install the `quota` package? You need to use the command (`setquota`)[setquota.md] to define the limits per user. The default quota is undefined, which is the source of this error. If you just installed every package just because and you don't actually need quotas, feel free to remove the package with `box remove quota` +## RuTorrent says I have no space left on my disk + +Please see the chapter above. + From d29e8cea23705bc95037567ba47fe0ff7ee28329 Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sat, 9 May 2020 23:24:06 +0000 Subject: [PATCH 05/10] Remove extra comma in json --- website/sidebars.json | 124 +++++++++++++++++++++--------------------- 1 file changed, 62 insertions(+), 62 deletions(-) diff --git a/website/sidebars.json b/website/sidebars.json index b012f6ce..e2f8773e 100644 --- a/website/sidebars.json +++ b/website/sidebars.json @@ -1,63 +1,63 @@ { - "docs": { - "Getting Started": [ - "installation", - "getting-started/how-do-i-connect", - "getting-started/box-basics", - "getting-started/faqs" - ], - "Applications": [ - "applications/autodl", - "applications/bazarr", - "applications/btsync", - "applications/couchpotato", - "applications/csf", - "applications/deluge", - "applications/emby", - "applications/ffmpeg", - "applications/flood", - "applications/headphones", - "applications/jackett", - "applications/letsencrypt", - "applications/lidarr", - "applications/lounge", - "applications/medusa", - "applications/netdata", - "applications/nextcloud", - "applications/nginx", - "applications/nzbget", - "applications/nzbhydra", - "applications/ombi", - "applications/panel", - "applications/plex", - "applications/pyload", - "applications/quassel", - "applications/quota", - "applications/radarr", - "applications/rapidleech", - "applications/rclone", - "applications/rtorrent", - "applications/rutorrent", - "applications/sabnzbd", - "applications/shellinabox", - "applications/sickchill", - "applications/sickgear", - "applications/sonarr", - "applications/subsonic", - "applications/syncthing", - "applications/tautulli", - "applications/transmission", - "applications/vsftpd", - "applications/wireguard", - "applications/x2go", - "applications/xmr-stak", - "applications/znc" - ], - "Guides": [ - "guides/dist-upgrade" - ], - "Helper Scripts":[ - "scripts/setquota", - ] - } -} + "docs": { + "Getting Started": [ + "installation", + "getting-started/how-do-i-connect", + "getting-started/box-basics", + "getting-started/faqs" + ], + "Applications": [ + "applications/autodl", + "applications/bazarr", + "applications/btsync", + "applications/couchpotato", + "applications/csf", + "applications/deluge", + "applications/emby", + "applications/ffmpeg", + "applications/flood", + "applications/headphones", + "applications/jackett", + "applications/letsencrypt", + "applications/lidarr", + "applications/lounge", + "applications/medusa", + "applications/netdata", + "applications/nextcloud", + "applications/nginx", + "applications/nzbget", + "applications/nzbhydra", + "applications/ombi", + "applications/panel", + "applications/plex", + "applications/pyload", + "applications/quassel", + "applications/quota", + "applications/radarr", + "applications/rapidleech", + "applications/rclone", + "applications/rtorrent", + "applications/rutorrent", + "applications/sabnzbd", + "applications/shellinabox", + "applications/sickchill", + "applications/sickgear", + "applications/sonarr", + "applications/subsonic", + "applications/syncthing", + "applications/tautulli", + "applications/transmission", + "applications/vsftpd", + "applications/wireguard", + "applications/x2go", + "applications/xmr-stak", + "applications/znc" + ], + "Guides": [ + "guides/dist-upgrade" + ], + "Helper Scripts": [ + "scripts/setquota" + ] + } +} \ No newline at end of file From 9d9c789a3e910e9ef086a4a02ff8116067ca848c Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sat, 9 May 2020 23:26:23 +0000 Subject: [PATCH 06/10] Try fix he broken link? --- docs/getting-started/faqs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/faqs.md b/docs/getting-started/faqs.md index 3321400e..858628b9 100644 --- a/docs/getting-started/faqs.md +++ b/docs/getting-started/faqs.md @@ -40,7 +40,7 @@ It's unlikely that the partiton on *your* server is sda3, so you'll need to use ## The dashboard states I have 0 out of 0 remaining disk space. What's going on? -Did you install the `quota` package? You need to use the command (`setquota`)[setquota.md] to define the limits per user. The default quota is undefined, which is the source of this error. +Did you install the `quota` package? You need to use the (setquota)[setquota.md] script to define the limits per user. The default quota is undefined, which is the source of this error. If you just installed every package just because and you don't actually need quotas, feel free to remove the package with `box remove quota` From 3c0b27d9b565c39849c3f421d58341729dcf4a59 Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sat, 9 May 2020 23:54:33 +0000 Subject: [PATCH 07/10] remove .md --- docs/getting-started/faqs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/faqs.md b/docs/getting-started/faqs.md index 858628b9..03f5d826 100644 --- a/docs/getting-started/faqs.md +++ b/docs/getting-started/faqs.md @@ -40,7 +40,7 @@ It's unlikely that the partiton on *your* server is sda3, so you'll need to use ## The dashboard states I have 0 out of 0 remaining disk space. What's going on? -Did you install the `quota` package? You need to use the (setquota)[setquota.md] script to define the limits per user. The default quota is undefined, which is the source of this error. +Did you install the `quota` package? You need to use the (setquota)[setquota] script to define the limits per user. The default quota is undefined, which is the source of this error. If you just installed every package just because and you don't actually need quotas, feel free to remove the package with `box remove quota` From 3ce0de324579a780da4103cf4db0315f1e80b4b5 Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sun, 10 May 2020 00:00:14 +0000 Subject: [PATCH 08/10] ugh work link --- docs/getting-started/faqs.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/getting-started/faqs.md b/docs/getting-started/faqs.md index 03f5d826..abb2389e 100644 --- a/docs/getting-started/faqs.md +++ b/docs/getting-started/faqs.md @@ -36,11 +36,11 @@ sudo tune2fs -m 1 /dev/sda3 Will reserve 1% instead. -It's unlikely that the partiton on *your* server is sda3, so you'll need to use the command `lsblk` to determine which partition exactly to modify. +It's unlikely that the partition on *your* server is sda3, so you'll need to use the command `lsblk` to determine which partition exactly to modify. ## The dashboard states I have 0 out of 0 remaining disk space. What's going on? -Did you install the `quota` package? You need to use the (setquota)[setquota] script to define the limits per user. The default quota is undefined, which is the source of this error. +Did you install the `quota` package? You need to use the (setquota)[/scripts/setquota] script to define the limits per user. The default quota is undefined, which is the source of this error. If you just installed every package just because and you don't actually need quotas, feel free to remove the package with `box remove quota` From 367e9ae6705ed86fe3039c539dbf71008e103365 Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sun, 10 May 2020 00:02:51 +0000 Subject: [PATCH 09/10] I might be big dumb --- docs/getting-started/faqs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/faqs.md b/docs/getting-started/faqs.md index abb2389e..52bd7a7c 100644 --- a/docs/getting-started/faqs.md +++ b/docs/getting-started/faqs.md @@ -40,7 +40,7 @@ It's unlikely that the partition on *your* server is sda3, so you'll need to use ## The dashboard states I have 0 out of 0 remaining disk space. What's going on? -Did you install the `quota` package? You need to use the (setquota)[/scripts/setquota] script to define the limits per user. The default quota is undefined, which is the source of this error. +Did you install the `quota` package? You need to use the [`setquota`](setquota.md) script to define the limits per user. The default quota is undefined, which is the source of this error. If you just installed every package just because and you don't actually need quotas, feel free to remove the package with `box remove quota` From 046635bd3cdd5e4847b378a3bc7baa0e7681561d Mon Sep 17 00:00:00 2001 From: flying-sausages Date: Sun, 10 May 2020 00:04:32 +0000 Subject: [PATCH 10/10] DId facebook lie to me --- docs/getting-started/faqs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/faqs.md b/docs/getting-started/faqs.md index 52bd7a7c..fa55b1db 100644 --- a/docs/getting-started/faqs.md +++ b/docs/getting-started/faqs.md @@ -40,7 +40,7 @@ It's unlikely that the partition on *your* server is sda3, so you'll need to use ## The dashboard states I have 0 out of 0 remaining disk space. What's going on? -Did you install the `quota` package? You need to use the [`setquota`](setquota.md) script to define the limits per user. The default quota is undefined, which is the source of this error. +Did you install the `quota` package? You need to use the [`setquota`](setquota) script to define the limits per user. The default quota is undefined, which is the source of this error. If you just installed every package just because and you don't actually need quotas, feel free to remove the package with `box remove quota`