add VPS utils

diff --git a/vps-utils/README.md b/vps-utils/README.md
new file mode 100644 (file)
index 0000000..3dbce19
--- /dev/null
+++ b/vps-utils/README.md
@@ -0,0 +1,47 @@
+---
+title: VPS Utils
+homepage: https://webinstall.dev/vps-utils
+tagline: |
+  VPS Utils make it easy to setup and manage a VPS
+description: |
+  VPS Utils includes shortcut commands for some common tasks, including `cap-net-bind`, 'vps-addswap', and 'vps-myip'
+---
+
+**cap-net-bind**:
+
+`cap-net-bind` will give the specified program the ability to listen on
+privileged ports, such as 80 (http) and 443 (https) without `root` privileges or
+`sudo`.
+
+```bash
+sudo cap-net-bind node
+```
+
+This is the same as running the full command:
+
+```bash
+setcap 'cap_net_bind_service=+ep' $(readlink -f $(which node))
+```
+
+**vps-myip**:
+
+Will output externally detected IPv4 and IPv6 addresses. See
+<https://webinstall.dev/vps-myip>.
+
+```bash
+vps-myip
+```
+
+```txt
+IPv4 (A)   : 136.36.196.101
+IPv6 (AAAA): 2605:a601:a919:9800:f8be:f2c4:9ad7:9763
+```
+
+**vps-addswap**:
+
+Adds and activates permanent swap in `/var/swapfile`. See
+<https://webinstall.dev/vps-addswap>.
+
+```bash
+vps-addswap
+```

diff --git a/vps-utils/cap-net-bind.sh b/vps-utils/cap-net-bind.sh
new file mode 100644 (file)
index 0000000..30f1fe5
--- /dev/null
+++ b/vps-utils/cap-net-bind.sh
@@ -0,0 +1,17 @@
+#!/bin/bash
+
+{
+    set -e
+    set -u
+
+    my_bin="$1"
+    if [ -z "$(which $my_bin)"]; then
+        echo "'$my_bin' not found"
+        exit 1
+    fi
+    my_sudo=""
+    if [ -n "$(command -v sudo)" ]; then
+        my_sudo=sudo
+    fi
+    $my_sudo setcap 'cap_net_bind_service=+ep' $(readlink -f $(which $my_bin))
+}

diff --git a/vps-utils/install.sh b/vps-utils/install.sh
new file mode 100644 (file)
index 0000000..b8c6658
--- /dev/null
+++ b/vps-utils/install.sh
@@ -0,0 +1,9 @@
+{
+    rm -f "$HOME/.local/bin/vps-myip" "$HOME/.local/bin/vps-addswap" "$HOME/.local/bin/cap-net-bind"
+    #webi_download  "$WEBI_HOST/packages/vps-utils/" "$HOME/.local/bin/"
+    webi_download  "$WEBI_HOST/packages/vps-utils/cap-net-bind.sh" "$HOME/.local/bin/cap-net-bind"
+    webi_download  "$WEBI_HOST/packages/vps-utils/vps-myip.sh" "$HOME/.local/bin/vps-myip"
+    webi_download  "$WEBI_HOST/packages/vps-utils/vps-addswap.sh" "$HOME/.local/bin/vps-addswap"
+    chmod a+x "$HOME/.local/bin/cap-net-bind"*
+    chmod a+x "$HOME/.local/bin/vps-"*
+}

diff --git a/vps-utils/vps-addswap.sh b/vps-utils/vps-addswap.sh
new file mode 120000 (symlink)
index 0000000..e35a636
--- /dev/null
+++ b/vps-utils/vps-addswap.sh
@@ -0,0 +1 @@
+../vps-addswap/install.sh
\ No newline at end of file

diff --git a/vps-utils/vps-myip.sh b/vps-utils/vps-myip.sh
new file mode 120000 (symlink)
index 0000000..aaa6265
--- /dev/null
+++ b/vps-utils/vps-myip.sh
@@ -0,0 +1 @@
+../vps-myip/install.sh
\ No newline at end of file