add start of knowledgebase

.gitea/workflows/close-inactive-issues.yml

@@ -0,0 +1,23 @@
+name: Close inactive issues
+on:
+  schedule:
+    # Runs at 1am every day
+    - cron: "0 1 * * *"
+
+jobs:
+  close-issues:
+    runs-on: ubuntu-20.04
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/stale@v5
+        with:
+          days-before-issue-stale: 30
+          days-before-issue-close: 14
+          stale-issue-label: "Status/Abandoned"
+          stale-issue-message: "This issue is abandoned because it has been open for 30 days with no activity."
+          close-issue-message: "This issue was closed because it has been inactive for 14 days since being marked as abandoned."
+          days-before-pr-stale: -1
+          days-before-pr-close: -1
+          repo-token: ${{ secrets.GITEA_TOKEN }}

guides/docker/home.md

@@ -0,0 +1,13 @@
+---
+title: Docker Home
+description: Docker guides
+published: true
+date: 2023-06-27T11:06:30.081Z
+tags: docker
+editor: markdown
+dateCreated: 2023-06-27T11:06:59.640Z
+---
+
+# Pages
+
+N/A

guides/linux/home.md

@@ -0,0 +1,14 @@
+---
+title: Linux Home
+description: Linux guides
+published: true
+date: 2023-06-27T11:15:30.081Z
+tags: linux
+editor: markdown
+dateCreated: 2023-06-27T11:15:59.640Z
+---
+
+# Pages
+
+- [Basics](/guides/linux/pages/basics)
+- [How to use Cronjobs](/guides/linux/pages/cronjob)

guides/linux/pages/basics.md

@@ -0,0 +1,93 @@
+---
+title: The basics of Linux
+description: Simple examples showing you around Linux
+published: true
+date: 2023-06-27T07:54:18.672Z
+tags: linux, server
+editor: markdown
+dateCreated: 2023-06-27T07:54:18.672Z
+---
+
+# Linux Basics
+
+This guide provides a brief introduction to Linux, including basic commands and concepts.
+
+## Navigating the filesystem
+
+- Change a directory: `cd <directory>`
+- List files in a directory: `ls`
+- List files in a directory (including hidden files): `ls -a`
+- Getting the current directory: `pwd`
+- Going back a directory: `cd ..`
+
+## Managing Files and Directories
+
+- Create a new directory: `mkdir <directory>`
+- Create a new file: `touch <file>`
+- Copy a file: `cp <file> <new-file>`
+- Remove a file: `rm <file>`
+- Remove a directory: `rm -r <directory>`
+
+## File Permissions
+
+- Change file permissions: `chmod <permissions> <file>`
+- Change file ownership: `chown <user> <file>`
+- Change file ownership (recursively): `chown -R <user> <directory>`
+- View file permissions: `ls -l <file>`
+
+## Text Processing
+
+There are alternatives to nano, but it is the easiest to use.
+
+- Edit a file: `nano <file>`
+- View a file: `cat <file>`
+- View a file (with line numbers): `cat -n <file>`
+- Get the beginning of a file: `head <file>`
+- Get the end of a file: `tail <file>`
+
+## File Compression and Archiving
+
+- Create a tar archive: `tar -cvf <archive.tar> <file>`
+- Extract a tar archive: `tar -xvf <archive.tar>`
+- Create a zip archive: `zip <archive.zip> <file>`
+- Extract a zip archive: `unzip <archive.zip>`
+
+## Package Management (Ubuntu)
+
+- Update package lists: `sudo apt update`
+- Install a package: `sudo apt install <package>`
+- Purge a package: `sudo apt purge <package>`
+- Remove a package: `sudo apt remove <package>`
+- Search for a package: `apt search <package>`
+- Upgrade packages: `sudo apt upgrade`
+
+## Networking
+
+- Get all interface ips: `ip a`
+- Ping a host: `ping <host>`
+- Get the public IP: `curl ifconfig.me`
+- Get the public IP (alternative): `curl ipinfo.io/ip`
+
+## Firewall (UFW)
+
+Make sure to allow SSH before enabling the firewall, otherwise you will be locked out of your server. `sudo ufw allow ssh`
+
+- Enable the firewall: `sudo ufw enable`
+- Disable the firewall: `sudo ufw disable`
+- List all rules: `sudo ufw status`
+- List all rules (showing numbers): `sudo ufw status numbered`
+- Delete a rule: `sudo ufw delete <rule>`
+- Allow a port: `sudo ufw allow <port>`
+- Deny a port: `sudo ufw deny <port>`
+- Allow a service: `sudo ufw allow <service>`
+- Deny a service: `sudo ufw deny <service>`
+
+## Service Management (Systemd)
+
+- Start a service: `sudo systemctl start <service>`
+- Stop a service: `sudo systemctl stop <service>`
+- Check the status of a service: `sudo systemctl status <service>`
+- Restart a service: `sudo systemctl restart <service>`
+- Enable a service (start on boot): `sudo systemctl enable <service>`
+- Disable a service (stop on boot): `sudo systemctl disable <service>`
+- Reload a service: `sudo systemctl reload <service>`

guides/linux/pages/cronjob.md

@@ -0,0 +1,68 @@
+---
+title: How to use cronjobs
+description: Examples on how to use cronjob to automate tasks
+published: true
+date: 2023-06-27T08:28:13.676Z
+tags:
+editor: markdown
+dateCreated: 2023-06-27T08:28:13.676Z
+---
+
+# How to use cronjobs
+
+This guide provides examples on how to use cronjob to automate tasks. _This was tested on Ubuntu 22.04._
+
+## Get Started
+
+- Begin by opening a terminal and running the following command:
+
+```bash
+crontab -e
+```
+
+If it's the first time you're using cronjob, you will be asked to select an editor. You can choose `nano` or `vim`. If you're not familiar with either, choose `nano` as the guide is based on this and it's the easiest. This command will open the crontab file in the nano text editor.
+
+- Next, you need to define the cronjob. Add the following lines to the file:
+
+```bash
+* * * * * <command>
+```
+
+- Finally, you can save the file by pressing `Ctrl + X` and then `Y`.
+
+## Syntax
+
+```bash
+* <- minute (0-59)
+  * <- hour (0-23)
+    * <- day of month (1-31)
+      * <- month (1-12)
+        * <- day of week (0-6) (Sunday=0)
+          <command> <- the command to execute
+```
+
+## Examples
+
+### Run a command every minute
+
+```bash
+* * * * * <command>
+```
+
+### Run a command every 5 minutes
+
+```bash
+*/5 * * * * <command>
+```
+
+### Run a command every hour
+
+```bash
+0 * * * * <command>
+```
+
+### Run a command every day at midnight
+
+```bash
+0 0 * * * <command>
+```

guides/nodejs/home.md

@@ -0,0 +1,14 @@
+---
+title: NodeJS Home
+description: NodeJS Guides and Tutorials
+published: true
+date: 2023-06-27T11:06:30.081Z
+tags: nodejs
+editor: markdown
+dateCreated: 2023-06-27T11:06:59.640Z
+---
+
+# Pages
+
+- [Creating a Simple REST API](/guides/nodejs/pages/creating-a-simple-rest-api)
+- [Running a NodeJS Application in Docker](/guides/nodejs/pages/running-nodejs-in-docker)

guides/nodejs/pages/creating-a-simple-rest-api.md

@@ -0,0 +1,94 @@
+---
+title: Creating a Simple REST API
+description: Creating a simple REST API with NodeJS and Express
+published: true
+date: 2023-06-28T20:38:30.081Z
+tags: nodejs, rest, api, express
+editor: markdown
+dateCreated: 2023-06-28T20:38:59.640Z
+---
+
+# Creating a Simple REST API
+
+## Introduction
+
+In this guide we will be creating a simple REST API using NodeJS and Express. We will be using the following tools:
+
+- NodeJS
+- Express
+
+## Prerequisites
+
+- NodeJS installed
+- NPM installed
+
+## Creating the project
+
+1. First we need to create a new directory for our project. You can do this by creating a new folder in your file explorer or by using the following command:
+
+```bash
+mkdir nodejs-rest-api
+```
+
+2. Next, we need to navigate to our new directory. We can do this by opening the folder in our file explorer or by using the following command:
+
+```bash
+cd nodejs-rest-api
+```
+
+3. Next, we need to initialize our project. We can do this by running the following command:
+
+```bash
+npm init -y
+```
+
+4. Next, we need to install the Express package. We can do this by running the following command:
+
+```bash
+npm install express
+```
+
+5. Next, we need to create a new file called `index.js`.
+
+6. Next, we need to open the `index.js` file and add the following code:
+
+```javascript
+const express = require("express");
+const app = express();
+```
+
+This will import the Express package and create a new Express application.
+
+7. Next, we need to add the following code to the `index.js` file:
+
+```javascript
+app.get("/", (req, res) => {
+	res
+		.contentType("application/json")
+		.send(JSON.stringify({ message: "Hello World!" }));
+});
+```
+
+This will create a new route that will return a JSON object with the message "Hello World!".
+
+8. Next, we need to add the following code to the `index.js` file:
+
+```javascript
+app.listen(3000, () => {
+	console.log("Server is running on port 3000");
+});
+```
+
+This will start the server on port 3000.
+
+9. Next, we need to run the following command to start the server:
+
+```bash
+node index.js
+```
+
+10. Next, we need to open our browser and navigate to `http://localhost:3000/`. We should see the message "{message: "Hello World!"}".
+
+## Conclusion
+
+In this guide we created a simple REST API using NodeJS and Express. We created a new directory for our project, initialized our project, installed the Express package, created a new file called `index.js`, added the code to the `index.js` file, and started the server.

guides/nodejs/pages/running-nodejs-in-docker.md

@@ -0,0 +1,103 @@
+---
+title: Running a NodeJS application in Docker
+description: Guide for running a NodeJS application in Docker
+published: true
+date: 2023-06-28T20:38:30.081Z
+tags: nodejs, docker
+editor: markdown
+dateCreated: 2023-06-28T20:38:59.640Z
+---
+
+# Running a NodeJS application in Docker
+
+We will be using the guide [Creating a Simple REST API](/guides/nodejs/pages/creating-a-simple-rest-api) as the example application.
+
+## Prerequisites
+
+- Docker installed
+- Docker Compose installed
+
+## Get Started
+
+1. First we need to create a new file called `Dockerfile`.
+
+2. Next, we need to open the `Dockerfile` file and add the following code:
+
+```dockerfile
+FROM node:latest
+
+WORKDIR /app
+
+COPY package*.json ./
+
+RUN npm install
+
+COPY . .
+
+EXPOSE 3000
+
+CMD ["node", "index.js"]
+```
+
+3. Now we can move on to the `docker-compose.yml` file. We need to create a new file called `docker-compose.yml`.
+
+4. Next, we need to open the `docker-compose.yml` file and add the following code:
+
+```yaml
+version: "3.9"
+
+services:
+  nodejs_rest_api:
+    build: .
+    restart: unless-stopped
+    ports:
+      - "3000:3000"
+```
+
+This will create a new service called `nodejs_rest_api` and build the Docker image using the `Dockerfile` in the current directory.
+
+5. You can now copyy the project files to where you want to run the application.
+
+6. Next, we need to open the terminal and run the following command:
+
+```bash
+docker-compose up -d
+```
+
+This will start the application in the background.
+
+7. Next, we need to open a web browser and navigate to `http://server_ip:3000`.
+
+You should now see your application running.
+
+## Updating the application
+
+1. First we need to open the terminal and run the following command:
+
+```bash
+docker-compose down
+```
+
+This will stop the application.
+
+2. Next, we need to update the application files. You can do this by copying the updated files to the server.
+
+3. Next, we need to open the terminal and run the following command:
+
+```bash
+docker-compose build
+```
+
+This will re-build the Docker image.
+
+4. Next, we need to open the terminal and run the following command:
+
+```bash
+docker-compose up -d
+```
+
+This will start the application in the background again.
+
+## Finished
+
+You have now successfully created a NodeJS application and run it in Docker and know how to update it.

guides/ubuntu/home.md

@@ -0,0 +1,21 @@
+---
+title: Ubuntu Home
+description: Ubuntu guides
+published: true
+date: 2023-06-27T11:35:30.081Z
+tags: ubuntu
+editor: markdown
+dateCreated: 2023-06-27T11:35:59.640Z
+---
+
+# Pages
+
+Below is a list of guides for Ubuntu.
+
+## Ubuntu 22.04
+
+- [Expanding an LVM](/guides/ubuntu/pages/22_04/expanding-an-lvm)
+- [Installing MongoDB](/guides/ubuntu/pages/22_04/install-mongodb)
+- [Installing Node.js](/guides/ubuntu/pages/22_04/install-nodejs)
+- [Installing Docker](/guides/ubuntu/pages/22_04/install-docker)
+- [Systemd service](/guides/ubuntu/pages/22_04/systemd-service)

guides/ubuntu/pages/22_04/expanding-an-lvm.md

@@ -0,0 +1,66 @@
+---
+title: Expanding a LVM
+description: How to expand a LVM
+published: true
+date: 2023-06-27T07:54:18.672Z
+tags: linux, server, ubuntu, lvm, ubuntu 22.04
+editor: markdown
+dateCreated: 2023-06-27T07:54:18.672Z
+---
+
+# Expanding a LVM
+
+This guide provides instructions on how to expand a LVM. _This was tested on Ubuntu 22.04._
+
+## Get Started
+
+- Begin by opening a terminal and running the following command:
+
+```bash
+lvdisplay
+```
+
+This command will display the volume groups.
+
+You should see something like this:
+
+```bash
+--- Logical volume ---
+LV Path                /dev/ubuntu-vg/ubuntu-lv
+LV Name                ubuntu-lv
+VG Name                ubuntu-vg
+LV UUID                eIxgxf-ABCD-EFGH-IJKL-MNOP-QRsT-UVWxYz
+LV Write Access        read/write
+LV Creation host, time ubuntu, 2023-06-27 08:00:00 +0000
+LV Status              available
+# open                 1
+LV Size                50.00 GiB
+Current LE             12800
+Segments               1
+Allocation             inherit
+Read ahead sectors     auto
+- currently set to     256
+Block device           253:0
+```
+
+You can find the volume we will be expanding by looking at the `LV Path` it should be something like `/dev/ubuntu-vg/ubuntu-lv`.
+
+- Next, you need to expand the volume. Run the following command:
+
+```bash
+lvextend -l +100%FREE /dev/ubuntu-vg/ubuntu-lv
+```
+
+This command will expand the volume to use all available space.
+
+- Finally, you need to expand the filesystem. Run the following command:
+
+```bash
+resize2fs /dev/ubuntu-vg/ubuntu-lv
+```
+
+This command will expand the filesystem to use all available space.
+
+## Finished
+
+You now have a LVM that has been expanded to use all available space.

guides/ubuntu/pages/22_04/install-docker.md

@@ -3,7 +3,7 @@ title: How to install Docker
 description: How to install Docker on Ubuntu 22.04
 published: true
 date: 2023-06-26T10:57:30.081Z
-tags: docker, ubuntu, installation, containerization, container, linux, server, ubuntu
+tags: docker, ubuntu, installation, containerization, container, linux, server, ubuntu, ubuntu 22.04
 editor: markdown
 dateCreated: 2023-06-26T10:43:59.640Z
 ---

guides/ubuntu/pages/22_04/install-mongodb.md

@@ -0,0 +1,223 @@
+---
+title: Installing MongoDB
+description: How to install MongoDB on Ubuntu 22.04
+published: true
+date: 2023-06-28T12:09:18.672Z
+tags: linux, server, ubuntu, mongodb, ubuntu 22.04
+editor: markdown
+dateCreated: 2023-06-28T12:09:18.672Z
+---
+
+# Installing MongoDB
+
+This guide provides instructions on how to install MongoDB on Ubuntu 22.04. Installing Mongo is a fairly simple process.
+
+## Updating the System
+
+- We will start by updating the apt package list. Run the following command:
+
+```bash
+sudo apt update
+```
+
+This will update the apt package list so that we ensure that the latest versions of packages are available.
+
+- Next, we will upgrade the packages. Run the following command:
+
+```bash
+sudo apt upgrade
+```
+
+This will upgrade the packages to the latest versions.
+
+## Installing required packages
+
+- Now, we will install some packages that are required. Run the following command:
+
+```bash
+sudo apt install gnupg2 wget
+```
+
+## Installing MongoDB
+
+1. Import the MongoDB GPG key. Run the following command:
+
+```bash
+wget -nc https://www.mongodb.org/static/pgp/server-6.0.asc
+cat server-6.0.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/mongodb.gpg >/dev/null
+```
+
+These commands will download the GPG key and import it, which will allow us to verify the packages.
+
+2. Add MongoDB to the apt sources list. Run the following command:
+
+```bash
+sudo sh -c 'echo "deb [ arch=amd64,arm64 signed-by=/etc/apt/keyrings/mongodb.gpg] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" >> /etc/apt/sources.list.d/mongo.list'
+```
+
+This command will add the MongoDB apt repository to the sources list.
+
+3. Update the apt package list. Run the following command:
+
+```bash
+sudo apt update
+```
+
+This will update the apt package list so that we ensure that the latest versions of packages are available.
+
+4. Install MongoDB. Run the following command:
+
+```bash
+sudo apt install mongodb-org
+```
+
+This will install the latest stable version of MongoDB.
+
+5. Start MongoDB. Run the following command:
+
+```bash
+sudo systemctl start mongod
+```
+
+6. Enable MongoDB so that it will automatically start on system boot. Run the following command:
+
+```bash
+sudo systemctl enable mongod
+```
+
+7. Verify that MongoDB is running. Run the following command:
+
+```bash
+sudo systemctl status mongod
+```
+
+You should see something like this:
+
+```bash
+● mongod.service - MongoDB Database Server
+     Loaded: loaded (/lib/systemd/system/mongod.service; enabled; vendor preset: enabled)
+     Active: active (running) since Tue 2023-06-27 08:00:00 UTC; 1min 30s ago
+       Docs: https://docs.mongodb.org/manual
+   Main PID: 1234 (mongod)
+      Tasks: 33 (limit: 4915)
+     Memory: 1.2G
+     CGroup: /system.slice/mongod.service
+             └─1234 /usr/bin/mongod --config /etc/mongod.conf
+```
+
+## Finished
+
+You have successfully installed MongoDB on Ubuntu 22.04. For user creation and securing MongoDB, please see the next sections.
+
+## Optional: Securing MongoDB
+
+1. Connect to MongoDB, so that we can create an admin user. Run the following command:
+
+```bash
+mongosh
+```
+
+2. Switch to the `admin` database. Run the following command:
+
+```bash
+use admin
+```
+
+3. Create an admin user. Run the following command:
+
+```bash
+db.createUser(
+  {
+    user: "admin",
+    pwd: "SET ME", # Generate a random string with: openssl rand -base64 32 | cut -c1-32
+    roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
+  }
+)
+```
+
+4. Exit the mongo shell. Run the following command:
+
+```bash
+exit
+```
+
+5. Now, we need to secure enable authentication, this will secure the server and prevent unauthorized access. Run the following command:
+
+```bash
+sudo nano /etc/mongod.conf
+```
+
+6. Find the `security` section. We need to uncomment it, and add the following line below it, it should look like this:
+
+```bash
+security:
+  authorization: enabled
+```
+
+7. Save the file and exit the editor. You can do this by pressing `CTRL + X`, then `Y`, then `ENTER`.
+
+## Optional: Adding a user / database
+
+1. Connect to MongoDB, so that we can create a user. Run the following command:
+
+```bash
+mongosh -u admin -p --authenticationDatabase admin
+```
+
+This will ask you for the password that you set earlier in the Securing MongoDB section, or if you didn't secure MongoDB, run the following command:
+
+```bash
+mongosh
+```
+
+2. Switch to the database that you want to add a user to eg: `forum`. Run the following command:
+
+```bash
+use forum
+```
+
+3. Create a user. Make sure to change the `db` to match the database used above. Run the following command:
+
+```bash
+db.createUser(
+  {
+    user: "forum",
+    pwd:  "SET ME", # Generate a random string with: openssl rand -base64 32 | cut -c1-32
+    roles: [ { role: "readWrite", db: "forum" } ]
+  }
+)
+```
+
+4. Exit the mongo shell. Run the following command:
+
+```bash
+exit
+```
+
+You have now created a user for the `forum` database. You can repeat this process for any other databases that you want to create users for.
+
+## Optional: Allowing remote connections
+
+1. Open the MongoDB configuration file. Run the following command:
+
+```bash
+sudo nano /etc/mongod.conf
+```
+
+2. Find the `net` section, we need to update the `bindIp` value, it should look like this:
+
+```bash
+net:
+  port: 27017
+  bindIp: 0.0.0.0
+```
+
+3. Save the file and exit the editor. You can do this by pressing `CTRL + X`, then `Y`, then `ENTER`.
+
+4. Restart MongoDB. Run the following command:
+
+```bash
+sudo systemctl restart mongod
+```
+
+You should now be able to connect to MongoDB from a remote machine.

guides/ubuntu/pages/22_04/install-nodejs.md

@@ -3,7 +3,7 @@ title: How to install NodeJS
 description: How to install NodeJS on Ubuntu 22.04
 published: true
 date: 2023-06-26T13:04:30.081Z
-tags: nodejs, ubuntu, installation, linux, server, ubuntu
+tags: nodejs, ubuntu, installation, linux, server, ubuntu, ubuntu 22.04
 editor: markdown
 dateCreated: 2023-06-26T13:04:59.640Z
 ---

guides/ubuntu/pages/22_04/systemd-service.md

@@ -3,7 +3,7 @@ title: How to create a Systemd service
 description: How to create a Systemd service on Ubuntu 22.04
 published: true
 date: 2023-06-26T13:28:49.025Z
-tags: docker, ubuntu, installation, containerization, container, linux, server, ubuntu, systemd, service
+tags: linux, server, ubuntu, systemd, service
 editor: markdown
 dateCreated: 2023-06-26T13:28:49.025Z
 ---
@@ -38,7 +38,7 @@ Description=<name>
 ExecStart=<command>
 WorkingDirectory=<directory>
 Restart=always
-User=root
+User=root (use a non root user for better security)
 
 [Install]
 WantedBy=multi-user.target

guides/unraid/home.md

@@ -0,0 +1,14 @@
+---
+title: Unraid Home
+description: Unraid guides
+published: true
+date: 2023-06-27T14:20:30.081Z
+tags: unraid
+editor: markdown
+dateCreated: 2023-06-27T14:20:59.640Z
+---
+
+# Pages
+
+- [Backing up a Docker application](/guides/unraid/pages/docker-app-backup)
+- [Recycle Bin](/guides/unraid/pages/recycle-bin)

guides/unraid/pages/docker-app-backup.md

@@ -0,0 +1,106 @@
+---
+title: Docker application backup
+description: How to backup a Docker application on Unraid
+published: true
+date: 2023-06-27T07:54:18.672Z
+tags: linux, server, unraid, backup
+editor: markdown
+dateCreated: 2023-06-27T07:54:18.672Z
+---
+
+# Docker application backup
+
+This guide will show you how to backup a Docker application on Unraid. _Tested on Unraid 6.12.1_
+
+## Get Started
+
+- Begin by installing the [User Scripts plugin](https://forums.unraid.net/topic/48286-plugin-ca-user-scripts/).
+- Now we need to create the script. Go to `Settings > User Utilites > User Scripts` and click `Add New Script`.
+- Give the script a name, for example `Backup Docker Application`.
+- Paste the following into the script:
+
+```bash
+#!/bin/bash
+
+# --- DO NOT TOUCH ---
+now="$(date +"%Y-%m-%d"@%H.%M)"
+
+# --- Variables ---
+
+# The name of the application
+applicationName="application_name"
+
+# The name of the backup
+backupName="backup-$(date +%Y-%m-%d_%H-%M-%S)"
+
+# Set the path to the application's data directory
+applicationData="/mnt/user/appdata/application_name/"
+
+# Set the path to the backup directory
+# Example: /mnt/user/Storage/Backups/$applicationName/
+backupDirectory=""
+
+# Set Number backups to keep
+backupsToKeep=30
+
+# The user of your account
+# Example: lee
+user=""
+
+# --- Backup Application ---
+
+# Start notification
+echo "Backup of $applicationName starting."
+/usr/local/emhttp/plugins/dynamix/scripts/notify -s "$applicationName Backup" -d "Backup of $applicationName starting."
+
+# Create backup directory
+mkdir -p "$backupDirectory"
+
+cd "$backupDirectory"
+
+# Create the backup tarball
+tar -cf "$applicationName-$now".tar "$applicationData"
+
+# Set Permissions
+chown "$user:$user" "$applicationName-$now".tar
+
+# Cleanup old backups
+for file in $(ls -t); do
+  if [[ $count -ge $backupsToKeep ]]; then
+    rm -- "$file"
+    echo "Deleted old backup: $file"
+  fi
+  ((count++))
+done
+
+# Stop notification
+echo "Backup of $applicationName completed!"
+/usr/local/emhttp/plugins/dynamix/scripts/notify -s "$applicationName Backup" -d "Backup of $applicationName completed!"
+```
+
+- You can now test the script by clicking `Run Script`. If everything is working correctly, you should see a notification in the top right corner of the screen.
+
+- Now we need to set the script to run on a schedule. Next to `Run In Background` you will see a dropdown menu. Select how often you want it to run and click `Apply`.
+
+## Restore a backup
+
+- Delete the application's data directory.
+- Copy the backup to the application's data directory.
+  Move the backup with the following command: (or via the Unraid web interface)
+
+```bash
+mv <backup_name>.tar /mnt/user/appdata/application_name/
+```
+
+- To restore a backup, simply extract the tarball and copy the files to the application's data directory.
+  You can extract the tarball by running the following command:
+
+```bash
+tar -xvf <backup_name>.tar
+```
+
+This command will extract the tarball to the current directory.
+
+## Finished
+
+You have now successfully setup a backup script for your Docker application. You can view the backups in the directory you set in the script.

guides/unraid/pages/recycle-bin.md

@@ -0,0 +1,45 @@
+---
+title: Save deleted files to the Recycle Bin
+description: A simple guide on how to save and restore deleted files via smb/samba
+published: true
+date: 2023-06-27T07:54:18.672Z
+tags: linux, server, unraid, backup
+editor: markdown
+dateCreated: 2023-06-27T07:54:18.672Z
+---
+
+# Save deleted files to the Recycle Bin
+
+This guide will show you how to save deleted files to the Recycle Bin on Unraid. _Tested on Unraid 6.12.1_
+
+## Get Started
+
+- Begin by installing the [Recycle Bin plugin](https://forums.unraid.net/topic/41044-recycle-bin-vfs-recycle-for-smb-shares/).
+- We now need to enable the plugin. Go to `Settings > User Utilities > Recycle Bin`.
+- Now we can configure the plugin. I have used the following settings:
+
+```bash
+Enable Recycle Bin > Yes
+Hide Recycle Bin Folder > No
+Update Recycle Bin Size in Background > Yes
+Enable on Unassigned Devices? > No
+Recycle Bin parameters > %m/%S
+Recycle Bin permission > Default
+Excluded Files > Empty
+Excluded Directories > This is where you can exclude directories from the Recycle Bin. For example: /mnt/user/Storage/Backups/
+Excluded Shares > You can put any share name that you want to exclude. Example: Plex-Media,Backups
+Age Days > 7 (This is how long the files will stay in the Recycle Bin before being deleted)
+Remove Aged Files on Schedule? > Weekly
+Remove Aged Files Notification? > Yes
+Log Deleted Files? > No
+```
+
+- Click `Apply` to save the settings.
+
+## Finished
+
+The Recycle Bin is now enabled and ready to use. You can test it by deleting a file from a share and then checking the Recycle Bin folder.
+
+## Extra
+
+This wont work for files deleted via the cli or the Unraid webui. This will only work for files deleted over smb/samba.

home.md

@@ -1,6 +1,6 @@
 ---
 title: Home
-description: Useful docs to help you in your Homelab
+description: Useful guides and documentation to help you learn and solve problems efficiently.
 published: true
 date: 2023-06-26T11:03:27.502Z
 tags:
@@ -18,8 +18,11 @@ Fascinated's Wiki is a comprehensive resource for Docker, Ubuntu, and more. Whet
 
 ## Topics Covered
 
-- Docker: Discover the power of containerization and learn how to efficiently package, deploy, and run applications using Docker containers.
-- Ubuntu: Explore the popular Linux distribution and learn how to set up and manage Ubuntu-based systems, including installation, configuration, and common tasks.
+- [Linux](/guides/linux/home): Explore the popular Linux distribution and learn how to set up and manage Linux-based systems, including installation, configuration, and common tasks.
+- [Ubuntu](/guides/ubuntu/home): Learn how to use Ubuntu. Ubuntu is a Linux distribution based on Debian.
+- [Docker](/guides/docker/home): Discover the power of containerization and learn how to efficiently package, deploy, and run applications using Docker containers.
+- [NodeJS](/guides/nodejs/home): Learn how to use NodeJS. NodeJS is a JavaScript runtime built on Chrome's V8 JavaScript engine.
+- [Unraid](/guides/unraid/home): Learn how to use Unraid. Unraid is a Linux-based operating system optimized for media file storage.
 
 ## How to Use
 
@@ -27,7 +30,7 @@ Navigate through the different topics using the menu on the left or the search b
 
 ## Contribute
 
-We encourage contributions from the community to improve and expand our content. If you have a tutorial, guide, or any valuable information related to Docker, Ubuntu, or other relevant topics, feel free to open a pull request on <https://git.fascinated.cc/Fascinated/docs>. Together, we can make the wiki a valuable resource for everyone.
+We encourage contributions from the community to improve and expand our content. If you have a tutorial, guide, or any valuable information related to Docker, Ubuntu, Linux, or other relevant topics, feel free to open a pull request on <https://git.fascinated.cc/Fascinated/docs>. Together, we can make the wiki a valuable resource for everyone.
 
 ## Contact
 

knowledgebase.md

@@ -0,0 +1,20 @@
+---
+title: Knowledgebase
+description: Collection of useful information related to Docker, Ubuntu, Linux, and other relevant topics
+published: true
+date: 2023-06-29T03:45:18.672Z
+tags:
+editor: markdown
+dateCreated: 2023-06-29T03:45:30.708Z
+---
+
+# Knowledgebase
+
+This is a collection of useful information related to Docker, Ubuntu, Linux, and other relevant topics.
+
+## Docker
+
+- What is Docker? Docker is a tool that helps you bundle up and use programs easily. It's like a box that holds all the things needed to run an app.
+- What is a Docker container? A Docker container is a small and self-contained package that has everything necessary to run a program. It's like a tiny computer that runs only one program.
+- What is a Docker image? A Docker image is a blueprint for creating a Docker container. It's like a recipe that tells Docker how to build a container.
+- What is Docker Compose? Docker Compose is a tool that makes it simple to manage and run multiple Docker containers together. It's like a manager that coordinates different containers for a group of apps.