From ce585907a0e7bd22ac3ee531dca72edc8e27f711 Mon Sep 17 00:00:00 2001 From: wompmacho Date: Wed, 25 Mar 2026 04:43:16 +0000 Subject: [PATCH] Style: Global Markdown structural and formatting &&audit & fix --- README.md | 3 +- _index.md | 4 +- posts/firstpost.md | 22 +- posts/liberal/index.md | 2 +- projects/Docker/index.md | 4 +- projects/NAS/index.md | 584 +++++++++++++------------- projects/Networking/index.md | 2 +- projects/Pihole/index.md | 19 +- projects/Pterodactyl/index.md | 3 +- projects/audiobookshelf/index.md | 4 +- projects/frigate/index.md | 8 +- projects/homarr/index.md | 4 +- projects/homepage/index.md | 2 +- projects/jellyfin/index.md | 6 +- projects/linkstack/index.md | 2 +- projects/mkdocs/index.md | 6 +- projects/nginx-proxy-manager/index.md | 2 +- projects/portainer/index.md | 2 +- projects/qbittorent/index.md | 17 +- projects/uptime-kuma/index.md | 4 +- projects/wikijs/index.md | 4 +- resume.md | 6 +- stream/stream_settings.md | 2 +- 23 files changed, 356 insertions(+), 356 deletions(-) diff --git a/README.md b/README.md index 671527b..1f3397f 100644 --- a/README.md +++ b/README.md @@ -15,9 +15,10 @@ Your Wiki architecture is decoupled. This repository contains the text, but the ## 🚀 Deployment -Pushing changes to the `main` branch automatically triggers the Gitea Action. +Pushing changes to the `main` branch automatically triggers the Gitea Action. The Runner: + 1. Checks out this repository. 2. Clones the `hugo-framework`. 3. Injects your Markdown and the `menus.en.toml`. diff --git a/_index.md b/_index.md index eb24ae1..589f080 100644 --- a/_index.md +++ b/_index.md @@ -1,9 +1,9 @@ --- -description: This is just the beginning... +description: This is just the beginning... title: HOME date: 2023-06-14T09:37:13.298Z lastmod: 2025-03-24 -tags: +tags: author: wompmacho --- diff --git a/posts/firstpost.md b/posts/firstpost.md index e442edc..7faf961 100644 --- a/posts/firstpost.md +++ b/posts/firstpost.md @@ -1,11 +1,11 @@ ---- -date: 2025-02-02 -lastmod: 2026-01-06 -author: "wompmacho" -authors: ["wompmacho"] -title: First Post ---- - -Yo 👋 - -If you actually come to find this then props to ya man. Thanks for dropping by. idk if this will be worth ever doing, but this was fun for me to set up... and who knows maybe this is of some use to others... so fuck it --> Enjoy. +--- +date: 2025-02-02 +lastmod: 2026-01-06 +author: "wompmacho" +authors: ["wompmacho"] +title: First Post +--- + +Yo 👋 + +If you actually come to find this then props to ya man. Thanks for dropping by. idk if this will be worth ever doing, but this was fun for me to set up... and who knows maybe this is of some use to others... so fuck it --> Enjoy. diff --git a/posts/liberal/index.md b/posts/liberal/index.md index 32cfccb..b03cdfa 100644 --- a/posts/liberal/index.md +++ b/posts/liberal/index.md @@ -9,7 +9,7 @@ showHero: false # needed to hide "hero banner" ## Liberal is bad. -Wait, wasn't this group touting to be "liberal" once? Tell me more about why Liberal is bad. You know what… that person looks funny and bothers me and calls themself a liberal so I don’t wanna be in that catagory anymore. No wait, actually lets just demonize a group because fox news says so. NO WAIT, let's not use words correctly because words, logic, facts... These things don't matter. +Wait, wasn't this group touting to be "liberal" once? Tell me more about why Liberal is bad. You know what… that person looks funny and bothers me and calls themself a liberal so I don’t wanna be in that catagory anymore. No wait, actually lets just demonize a group because fox news says so. NO WAIT, let's not use words correctly because words, logic, facts... These things don't matter. ![what is a lib](Screenshot_20250205-234147.png) diff --git a/projects/Docker/index.md b/projects/Docker/index.md index a7679f2..483fabe 100644 --- a/projects/Docker/index.md +++ b/projects/Docker/index.md @@ -47,7 +47,7 @@ sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg -# Add the repository to Apt sources: +## Add the repository to Apt sources: echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ @@ -77,7 +77,7 @@ sudo docker run hello-world ## Docker Files > [!NOTE] -> [dockerfile](https://docs.docker.com/reference/dockerfile/) +> [dockerfile](https://docs.docker.com/reference/dockerfile/) > > Example rebuild for mkdocs with some mods > diff --git a/projects/NAS/index.md b/projects/NAS/index.md index 3c8e538..1bfc122 100644 --- a/projects/NAS/index.md +++ b/projects/NAS/index.md @@ -1,292 +1,292 @@ ---- -title: NAS -description: NAS -date: 2024-05-04 -lastmod: 2024-05-11 -author: wompmacho -summary: "NAS build and some tips and tricks to get things working with your docker containers" -showTableOfContents: true -showHero: false # needed to hide "hero banner" ---- - -## What is a NAS? - -A Network Attached Storage (NAS) device is essentially a small, self-contained -computer that's designed solely for storing and sharing files. Think of it as -your own personal cloud storage, but instead of relying on a third-party -service, you own and control the hardware. - -Here's why someone might use a NAS: - -- **Centralized Storage:** A NAS provides a single location to store all your - files - documents, photos, videos, music, etc. This makes it easy to access - your data from any device on your network. -- **File Sharing:** NAS devices make it simple to share files between multiple - users and devices. This is great for families who want to share photos and - videos, or for small businesses who need to collaborate on documents. -- **Backup and Redundancy:** Many NAS devices offer features like automatic - backups and RAID configurations, which help protect your data from hard drive - failures. -- **Media Streaming:** NAS devices can be used to stream media files (movies, - music) to devices throughout your home, like smart TVs, game consoles, and - mobile devices. -- **Remote Access:** Some NAS devices allow you to access your files remotely - over the internet, so you can retrieve important documents or share photos - even when you're away from home. - -Essentially, a NAS is a versatile and convenient way to manage and share your -digital data. It offers more control and privacy than cloud storage services, -and it can be a valuable tool for both individuals and businesses. - ---- - -## TrueNAS - -TrueNAS is an Open Source NAS operating System / infrastructure solution. In -addition to powerful scale-out storage capabilities, TrueNAS SCALE adds Linux -Containers and VMs (KVM) so your organization can run workloads closer to data. - -### Why I switched - -Recently I switched over to TrueNas from my off the shelf -[Terramaster](https://shop.terra-master.com/products/terramaster-f5-422-10gbe-nas-5-bay-network-storage-server-intel-quad-core-cpu-with-hardware-encryption-diskless) -device. I actually really liked the Terramaster, it allowed a 5 drive pool with -raid 1 on a BTRFS filesystem. Which meant it was easy to upgrade the drives from -2TB --> 6TB giving me a decent ~24TB size pool *(one drive as parity)*. I got -this originally so that I could safely back up my data and store my 10TB+ of VOD -recordings from the Live Stream & Youtube. The Terramaster had some pretty big -drawbacks. It was only really good for being a simple NAS share. - -The proprietary operating System is actual hot garbage. - -- the GUI is extremely slow and freezes up a lot -- the built in docker containers and other special features rarely work -- the Recycle bin is hot garbage and runs even when you turn it off (discovered - nothing had **EVER** been deleted) -- the underlying linux OS somehow struggles to do basic things like deleting - files -- networking sometimes just broke, ignored static IPs and would ignore DNS due - to not properly turning off ipv6 -- there is little to no documentation or support outside of Terramaster official - forums, which is also hot garbage. - -Couple years later my data has continued to grow, including my -[jellyfin](../homelab/containers/jellyfin.md) media and other hoarding, so I -needed some space. This gave me a nice opertunity to upgrade. I have an older, -but still nice PC sitting around as a spare, so this was a good chance to -upgrade my NAS with some nice compute as well. - -### Why TrueNAS - -I went with TrueNAS SCALE because it used the newer [ZFS2 -filesystem](https://github.com/openzfs/zfs/releases) which allows for expansion -of pools. This would allow me to buy some extra drives, move over my data and -then expand using the old drive pool. SCALE also moved over to docker -containerization. Side benefit of allowing me to host some extra containers if I -want. Its also free and there is a lot of support / documentation out there. It -has come a long way from the FreeBSD days. - -### Refurbished Drives - -I had some issues when getting sourcing drives. Things are still pretty -expensive atm, so I went with just getting more 6TB and expanding the pool. *Can -upgrade size later when the prices chill out*. Managed to find a good price on -refurbished 6TB drives from amazon. **However**; when they arrived I found that -they were all heavily used 4 years+ uptime, reused from some Datacenter -somewhere. **Fucking scummy Amazon seller**. To top it off, some were SAS drives -out of NETAPP appliances. - -> [!ERROR] **Fuck you Netapp** -> -> Netapp is an older *shit* brand that would lock down their drives with special -> formatting that forced the customer to use only drives sourced from Netapp. -> These old Netapp appliances are starting to flood the market as newer / -> cheaper to run hardware is being deployed. - -> [!SUCCESS] -> Luckily, smart people can reformat the drives from their shit Data Integrity -> Feature (DIF) format back to a normal. This is a long and time consuming process -> *(Took DAYS)* as the entire drive has to be reformatted with a normal 512 chunk -> size. - -> [!NOTE] -> Thank you [smart guy from reddit](https://reddit.com/r/truenas/comments/12w68uc/how_to_get_rid_of_data_integrity_feature_from/) that pointed me to the [smart guy on TrueNAS forum](https://www.truenas.com/community/threads/troubleshooting-disk-format-warnings-in-truenas-scale.106051/) that showed me how to fix these un-usable drives. -> -> TrueNAS has `sg_format` built in. With this you can reformat all the drives at the **same time**. -> -> ``` shell -> # formatting -> sg_format --format --size=512 /dev/sdb -> -> # progress -> sudo sg_turs --progress /dev/sdb -> ``` - -> [!warning] -> This still took multiple days with a 6TB drive :( - -### Safely copying files - -One problem I ran into was; how do I make sure everything is copied over safely from one pool to another? I could drag and drop folders, but that would have taken months and risked missing data. Best bet was to use `rsync` *(which is also the fastest way to transfer)*. `rsync` has the added benefit of using checksum checking to verify all data is safely transferred with no errors. Luckily both systems were on linux, which made this easier. - -> [!NOTE] -> I started by doing this after logging into my old Terramaster NAS and performing the `rsync` operation from there. This was a bad idea and too longer, because the OS is slow and CPU can not handle handling all this plus 10GB networking at once. If you do this, do this from a system with a decent CPU. - -- Mount your systems together via the device with the best CPU - -``` bash -#mount in fstab -# -nas:/mnt/md0/VODS /mnt/tnas/vods nfs defaults 0 0 -``` - -- Run `rsync` in the shell and move your folders using recursive options - -``` bash -# Coping folders recursively with Progress & Stats -sudo rsync -avh -A --no-perms --progress --stats /mnt/tnas/store/Backups/ /mnt/store/vault/Backups/ & -``` - -> [!NOTE] -> `rsync` keeps logs and will run faster the next time around. Recommend running it a few times to add a extra verification that all your files have transferred. - -> [!NOTE] -> You can use `--progress --stats` and the `&` operator to send the job to the background. This will alow you to bring the job to the foreground whenever you want to check on progress. This is super useful when transferring terabytes of data. - -> [!NOTE] -> If doing this from TrueNAS, might be better to set this up as a one time cronjob. TrueNAS might kill this job if you lose connection to the shell while transferring. -> - add the job using the user interface *(do not enable the job)* -> -> ![adding a cron job](creating_a_cronjob_with_truenas.png) -> -> - run the job when you are ready to move files -> -> ![running a cron job](running_cron_job.png) - -### How to connect to a NAS - -#### CIFS - -Common Internet File System (CIFS) is a network file sharing protocol that -allows applications on computers to read and write files and request other -services from remote servers. Think of it as a way for your computer to talk to -another computer (or storage device) to access files. It's most commonly -associated with Windows environments, but it's used by other operating systems -as well. It is relatively secure, requiring username / password login to remote -systems. - -> [!NOTE] -> You might need this if you want to connect a Windows machine to one - running linux like a common NAS *(my use case)*. - -One example of a use case is a jellyfin container that needs persistent data -access for media (movies / tv shows) served from your nas. This will need this -to be mounted to the OS docker is running on and pass this through with the -volumes option in your docker compose file. - -**To add CIFS to Linux** - -For this you will also need the `keyutils` & `cifs-utils` packages. The `keyutils` -package is a library and a set of utilities for accessing the kernel keyring -facility. `cifs-utils` package provides a means for mounting SMB/CIFS shares on a -Linux system. - -``` bash -apt-get install keyutils && apt install cifs-utils -y -``` - -Then we will need to mount the remote storage via fstab so that it will -automatically mount to the OS every time the os boots. - -- create a file in your home directory "~/.smb" - -``` bash -vim ~/.smb -``` - -> [!INFO] -> The file should contain your NAS credentials *(domain optional/depends - on your nas settings)* -> -> ``` bash -> username=NAS_USERNAME -> password=NAS_PASSWORD -> domain=NAS_DOMAIN_GROUP -> ``` - -- Create an entry in the fstab - -``` bash -vim /etc/fstab -``` - -- Add an entry to the bottom line of the file - -``` bash -# //{Nas_IP/Hostname}/{Nas_Mount_Point} /mnt/{mount_name_on_docker_os} cifs credentials=/[path_to_credentials].smb,x-systemd.automount 0 0 - -# Example: -//nas.home/store /mnt/store cifs credentials=/home/wompmacho/.smb,x-systemd.automount 0 0 -``` - -- Save your file and re-mount all - -``` bash -mount -a -``` - -- make sure your mount section of your docker compose matches the - `mount_name_on_docker_os` and reboot your system - -``` bash -# example: - volumes: - - /app/jellyfin/config:/config - - /mnt/store:/data/store -``` - -> [!SUCCESS] -> -> You can check that they are mounted by navigating to where you mounted the files -> -> ``` bash -> wompmacho@docker:~$ cd /mnt/store/MediaServer/ -> Movies/ Music/ Torrent/ Tv Shows/ -> ``` - -#### NFS - -NFS (Network File System) is a distributed file system protocol that allows users to access files and directories over a network as if they were located on their local computer. It's a way for your computer to talk to another computer (or storage device) to access files, similar to CIFS, but more commonly used in Unix/Linux environments. - -> [!WARNING] -> There is `NO SECURITY` on NFS. It uses existing ACL groups to manage permissions. Only use this on a local network and for trusted devices. - -> [!SUCCESS] -> On TrueNAS you can limit access to on IP address or limit within your local domain. -> -> ![alt text](truenas_nfs_limit_to_local_network.png) - -> [!Info] -> One thing to consider when working with TrueNas: -> - When creating the initial dataset in your pool, set the zfs **aclmode** on the dataset in question to `passthrough`. -> - Special thanks to `anodos` you solved am issue plaguing me --> [Truenas Forum](https://www.truenas.com/community/threads/cannot-chmod-nfs-operation-not-permitted.97247/) - ---- - -#### SMB - -Server Message Block (SMB) is a network communication protocol that allows computers to share files, printers, and other resources with each other. It's the foundation of file sharing in **Windows** environments, but it's also used by other operating systems like macOS and Linux. - -**To connect to a SMB share on Windows:** - -- Right Click to add a `Network Location` - -![adding a network location](adding_smb_windows.png) - -- Use the IP address or hostname of the NAS and the share path provided to your folder access - -![selecting the network path for smb](selecting_network_path_for_smb.png) - -> [!NOTE] -> For windows you will need to enter a username / password for access to the share - +--- +title: NAS +description: NAS +date: 2024-05-04 +lastmod: 2024-05-11 +author: wompmacho +summary: "NAS build and some tips and tricks to get things working with your docker containers" +showTableOfContents: true +showHero: false # needed to hide "hero banner" +--- + +## What is a NAS? + +A Network Attached Storage (NAS) device is essentially a small, self-contained +computer that's designed solely for storing and sharing files. Think of it as +your own personal cloud storage, but instead of relying on a third-party +service, you own and control the hardware. + +Here's why someone might use a NAS: + +- **Centralized Storage:** A NAS provides a single location to store all your + files - documents, photos, videos, music, etc. This makes it easy to access + your data from any device on your network. +- **File Sharing:** NAS devices make it simple to share files between multiple + users and devices. This is great for families who want to share photos and + videos, or for small businesses who need to collaborate on documents. +- **Backup and Redundancy:** Many NAS devices offer features like automatic + backups and RAID configurations, which help protect your data from hard drive + failures. +- **Media Streaming:** NAS devices can be used to stream media files (movies, + music) to devices throughout your home, like smart TVs, game consoles, and + mobile devices. +- **Remote Access:** Some NAS devices allow you to access your files remotely + over the internet, so you can retrieve important documents or share photos + even when you're away from home. + +Essentially, a NAS is a versatile and convenient way to manage and share your +digital data. It offers more control and privacy than cloud storage services, +and it can be a valuable tool for both individuals and businesses. + +--- + +## TrueNAS + +TrueNAS is an Open Source NAS operating System / infrastructure solution. In +addition to powerful scale-out storage capabilities, TrueNAS SCALE adds Linux +Containers and VMs (KVM) so your organization can run workloads closer to data. + +### Why I switched + +Recently I switched over to TrueNas from my off the shelf +[Terramaster](https://shop.terra-master.com/products/terramaster-f5-422-10gbe-nas-5-bay-network-storage-server-intel-quad-core-cpu-with-hardware-encryption-diskless) +device. I actually really liked the Terramaster, it allowed a 5 drive pool with +raid 1 on a BTRFS filesystem. Which meant it was easy to upgrade the drives from +2TB --> 6TB giving me a decent ~24TB size pool *(one drive as parity)*. I got +this originally so that I could safely back up my data and store my 10TB+ of VOD +recordings from the Live Stream & Youtube. The Terramaster had some pretty big +drawbacks. It was only really good for being a simple NAS share. + +The proprietary operating System is actual hot garbage. + +- the GUI is extremely slow and freezes up a lot +- the built in docker containers and other special features rarely work +- the Recycle bin is hot garbage and runs even when you turn it off (discovered + nothing had **EVER** been deleted) +- the underlying linux OS somehow struggles to do basic things like deleting + files +- networking sometimes just broke, ignored static IPs and would ignore DNS due + to not properly turning off ipv6 +- there is little to no documentation or support outside of Terramaster official + forums, which is also hot garbage. + +Couple years later my data has continued to grow, including my +[jellyfin](../homelab/containers/jellyfin.md) media and other hoarding, so I +needed some space. This gave me a nice opertunity to upgrade. I have an older, +but still nice PC sitting around as a spare, so this was a good chance to +upgrade my NAS with some nice compute as well. + +### Why TrueNAS + +I went with TrueNAS SCALE because it used the newer [ZFS2 +filesystem](https://github.com/openzfs/zfs/releases) which allows for expansion +of pools. This would allow me to buy some extra drives, move over my data and +then expand using the old drive pool. SCALE also moved over to docker +containerization. Side benefit of allowing me to host some extra containers if I +want. Its also free and there is a lot of support / documentation out there. It +has come a long way from the FreeBSD days. + +### Refurbished Drives + +I had some issues when getting sourcing drives. Things are still pretty +expensive atm, so I went with just getting more 6TB and expanding the pool. *Can +upgrade size later when the prices chill out*. Managed to find a good price on +refurbished 6TB drives from amazon. **However**; when they arrived I found that +they were all heavily used 4 years+ uptime, reused from some Datacenter +somewhere. **Fucking scummy Amazon seller**. To top it off, some were SAS drives +out of NETAPP appliances. + +> [!ERROR] **Fuck you Netapp** +> +> Netapp is an older *shit* brand that would lock down their drives with special +> formatting that forced the customer to use only drives sourced from Netapp. +> These old Netapp appliances are starting to flood the market as newer / +> cheaper to run hardware is being deployed. + +> [!SUCCESS] +> Luckily, smart people can reformat the drives from their shit Data Integrity +> Feature (DIF) format back to a normal. This is a long and time consuming process +> *(Took DAYS)* as the entire drive has to be reformatted with a normal 512 chunk +> size. + +> [!NOTE] +> Thank you [smart guy from reddit](https://reddit.com/r/truenas/comments/12w68uc/how_to_get_rid_of_data_integrity_feature_from/) that pointed me to the [smart guy on TrueNAS forum](https://www.truenas.com/community/threads/troubleshooting-disk-format-warnings-in-truenas-scale.106051/) that showed me how to fix these un-usable drives. +> +> TrueNAS has `sg_format` built in. With this you can reformat all the drives at the **same time**. +> +> ``` shell +> # formatting +> sg_format --format --size=512 /dev/sdb +> +> # progress +> sudo sg_turs --progress /dev/sdb +> ``` + +> [!warning] +> This still took multiple days with a 6TB drive :( + +### Safely copying files + +One problem I ran into was; how do I make sure everything is copied over safely from one pool to another? I could drag and drop folders, but that would have taken months and risked missing data. Best bet was to use `rsync` *(which is also the fastest way to transfer)*. `rsync` has the added benefit of using checksum checking to verify all data is safely transferred with no errors. Luckily both systems were on linux, which made this easier. + +> [!NOTE] +> I started by doing this after logging into my old Terramaster NAS and performing the `rsync` operation from there. This was a bad idea and too longer, because the OS is slow and CPU can not handle handling all this plus 10GB networking at once. If you do this, do this from a system with a decent CPU. + +- Mount your systems together via the device with the best CPU + +``` bash +#mount in fstab +# +nas:/mnt/md0/VODS /mnt/tnas/vods nfs defaults 0 0 +``` + +- Run `rsync` in the shell and move your folders using recursive options + +``` bash +## Coping folders recursively with Progress & Stats +sudo rsync -avh -A --no-perms --progress --stats /mnt/tnas/store/Backups/ /mnt/store/vault/Backups/ & +``` + +> [!NOTE] +> `rsync` keeps logs and will run faster the next time around. Recommend running it a few times to add a extra verification that all your files have transferred. + +> [!NOTE] +> You can use `--progress --stats` and the `&` operator to send the job to the background. This will alow you to bring the job to the foreground whenever you want to check on progress. This is super useful when transferring terabytes of data. + +> [!NOTE] +> If doing this from TrueNAS, might be better to set this up as a one time cronjob. TrueNAS might kill this job if you lose connection to the shell while transferring. +> - add the job using the user interface *(do not enable the job)* +> +> ![adding a cron job](creating_a_cronjob_with_truenas.png) +> +> - run the job when you are ready to move files +> +> ![running a cron job](running_cron_job.png) + +### How to connect to a NAS + +#### CIFS + +Common Internet File System (CIFS) is a network file sharing protocol that +allows applications on computers to read and write files and request other +services from remote servers. Think of it as a way for your computer to talk to +another computer (or storage device) to access files. It's most commonly +associated with Windows environments, but it's used by other operating systems +as well. It is relatively secure, requiring username / password login to remote +systems. + +> [!NOTE] +> You might need this if you want to connect a Windows machine to one + running linux like a common NAS *(my use case)*. + +One example of a use case is a jellyfin container that needs persistent data +access for media (movies / tv shows) served from your nas. This will need this +to be mounted to the OS docker is running on and pass this through with the +volumes option in your docker compose file. + +**To add CIFS to Linux** + +For this you will also need the `keyutils` & `cifs-utils` packages. The `keyutils` +package is a library and a set of utilities for accessing the kernel keyring +facility. `cifs-utils` package provides a means for mounting SMB/CIFS shares on a +Linux system. + +``` bash +apt-get install keyutils && apt install cifs-utils -y +``` + +Then we will need to mount the remote storage via fstab so that it will +automatically mount to the OS every time the os boots. + +- create a file in your home directory "~/.smb" + +``` bash +vim ~/.smb +``` + +> [!INFO] +> The file should contain your NAS credentials *(domain optional/depends + on your nas settings)* +> +> ``` bash +> username=NAS_USERNAME +> password=NAS_PASSWORD +> domain=NAS_DOMAIN_GROUP +> ``` + +- Create an entry in the fstab + +``` bash +vim /etc/fstab +``` + +- Add an entry to the bottom line of the file + +``` bash +## //{Nas_IP/Hostname}/{Nas_Mount_Point} /mnt/{mount_name_on_docker_os} cifs credentials=/[path_to_credentials].smb,x-systemd.automount 0 0 + +## Example: +//nas.home/store /mnt/store cifs credentials=/home/wompmacho/.smb,x-systemd.automount 0 0 +``` + +- Save your file and re-mount all + +``` bash +mount -a +``` + +- make sure your mount section of your docker compose matches the + `mount_name_on_docker_os` and reboot your system + +``` bash +## example: + volumes: + - /app/jellyfin/config:/config + - /mnt/store:/data/store +``` + +> [!SUCCESS] +> +> You can check that they are mounted by navigating to where you mounted the files +> +> ``` bash +> wompmacho@docker:~$ cd /mnt/store/MediaServer/ +> Movies/ Music/ Torrent/ Tv Shows/ +> ``` + +#### NFS + +NFS (Network File System) is a distributed file system protocol that allows users to access files and directories over a network as if they were located on their local computer. It's a way for your computer to talk to another computer (or storage device) to access files, similar to CIFS, but more commonly used in Unix/Linux environments. + +> [!WARNING] +> There is `NO SECURITY` on NFS. It uses existing ACL groups to manage permissions. Only use this on a local network and for trusted devices. + +> [!SUCCESS] +> On TrueNAS you can limit access to on IP address or limit within your local domain. +> +> ![alt text](truenas_nfs_limit_to_local_network.png) + +> [!Info] +> One thing to consider when working with TrueNas: +> - When creating the initial dataset in your pool, set the zfs **aclmode** on the dataset in question to `passthrough`. +> - Special thanks to `anodos` you solved am issue plaguing me --> [Truenas Forum](https://www.truenas.com/community/threads/cannot-chmod-nfs-operation-not-permitted.97247/) + +--- + +#### SMB + +Server Message Block (SMB) is a network communication protocol that allows computers to share files, printers, and other resources with each other. It's the foundation of file sharing in **Windows** environments, but it's also used by other operating systems like macOS and Linux. + +**To connect to a SMB share on Windows:** + +- Right Click to add a `Network Location` + +![adding a network location](adding_smb_windows.png) + +- Use the IP address or hostname of the NAS and the share path provided to your folder access + +![selecting the network path for smb](selecting_network_path_for_smb.png) + +> [!NOTE] +> For windows you will need to enter a username / password for access to the share + diff --git a/projects/Networking/index.md b/projects/Networking/index.md index 7ed02ea..a624a63 100644 --- a/projects/Networking/index.md +++ b/projects/Networking/index.md @@ -35,7 +35,7 @@ whether it's a local network or the vast expanse of the internet. --- -## IPv4 & IPv6 +## IPv4 & IPv6 IPv4 and IPv6 are two versions of the Internet Protocol (IP), which is the fundamental protocol that enables devices to communicate over the internet. diff --git a/projects/Pihole/index.md b/projects/Pihole/index.md index bd8f194..479d1a8 100644 --- a/projects/Pihole/index.md +++ b/projects/Pihole/index.md @@ -16,7 +16,7 @@ own. It can also operate as a internal dns router and dhcp server. ## Pihole Setup If you have a raspberry-pi or another device, its super easy to get things -going. +going. - [pihole setup](https://github.com/pi-hole/pi-hole/?tab=readme-ov-file#one-step-automated-install). @@ -29,16 +29,15 @@ need to do is set your devices to use your pihole as the **primary** dns server. curl -sSL https://install.pi-hole.net | bash ``` -> [!NOTE] -> I find this to be a little flaky when it comes to DNS, often times OS will need reboots and cache to be cleared in order to actively start using pihole DNS. -> +> [!NOTE] +> I find this to be a little flaky when it comes to DNS, often times OS will need reboots and cache to be cleared in order to actively start using pihole DNS. +> > Browsers also store dns info so many things can conflict before your DNS switches over. I find that using Pihole as primary DHCP server forces your - devices to use the correct DNS server and fixes a lot of problems. -> + devices to use the correct DNS server and fixes a lot of problems. +> > Also keep in mind that **ipv6** can interfere if you are like me and have a ISP - provider that tries to force their DNS - + provider that tries to force their DNS --- @@ -57,11 +56,11 @@ set proxmox to use dhcp rather than static ip and finally set pihole VM to automatically boot first so that when it connects to the gateway devices connected to the gateway are issued ip address from the pihole. -> [!WARNING] +> [!WARNING] > If you are using pihole for DHCP / DNS, keep in mind if the device goes down that is hosting your pihole server, so will your DNS / DHCP. This May prevent you from connecting to your network until you re-enable a dhcp server such as -the one in your router. +the one in your router. - reserve a ip address in router/gateway for proxmox server & pihole diff --git a/projects/Pterodactyl/index.md b/projects/Pterodactyl/index.md index 73fd9c0..5b20420 100644 --- a/projects/Pterodactyl/index.md +++ b/projects/Pterodactyl/index.md @@ -22,7 +22,7 @@ use the default port 80 for web. reverse proxy is designed for normal web traffic, not game servers. If you are annoying like me and wanna put things on a single server and save -money... here is what you can do. +money... here is what you can do. - [Creating SSL Certificates](https://pterodactyl.io/tutorials/creating_ssl_certificates.html#method-2:-acme.sh-(using-cloudflare-api)) @@ -38,7 +38,6 @@ money... here is what you can do. # OpenSSL Self-Signed Certificate Command: openssl req -sha256 -addext "subjectAltName = DNS:games.local" -newkey rsa:4096 -nodes -keyout privkeyselfsigned.pem -x509 -days 3650 -out fullchainselfsigned.pem - # nginx-proxy-manager with cloudflare ssl cert setup # proxy side should be http # do not force ssl on cert side diff --git a/projects/audiobookshelf/index.md b/projects/audiobookshelf/index.md index e249137..a25ec15 100644 --- a/projects/audiobookshelf/index.md +++ b/projects/audiobookshelf/index.md @@ -33,12 +33,12 @@ services: # The path to the left of the colon is the path on your computer, # and the path to the right of the colon is where the data is # available to ABS in Docker. - + # You can change these media directories or add as many as you want - /mnt/store/MediaServer/Audio_Books:/audiobooks - /mnt/store/MediaServer/podcasts:/podcasts - /mnt/store/app/audiobookshelf/metadata:/metadata - + # The config directory needs to be on the same physical machine # you are running ABS on - /app/audiobookshelf/config:/config diff --git a/projects/frigate/index.md b/projects/frigate/index.md index 1d479fd..04c8cd2 100644 --- a/projects/frigate/index.md +++ b/projects/frigate/index.md @@ -9,7 +9,7 @@ showHero: false # needed to hide "hero banner" ## What is Frigate? -`Frigate` is a complete and local NVR designed for Home Assistant with AI object detection. Uses OpenCV and Tensorflow to perform realtime object detection locally for IP cameras. +`Frigate` is a complete and local NVR designed for Home Assistant with AI object detection. Uses OpenCV and Tensorflow to perform realtime object detection locally for IP cameras. ```yaml # frigate - https://docs.frigate.video/frigate/installation/ @@ -41,9 +41,9 @@ services: requires to set a `config.yml` in the `/config` volume. -## My current config +## My current config -Am not currently running the optimized setup for this, but testing things out. +Am not currently running the optimized setup for this, but testing things out. ```yaml mqtt: @@ -82,7 +82,7 @@ detectors: type: cpu num_threads: 3 -# Include all cameras by default in Birdseye view +## Include all cameras by default in Birdseye view birdseye: enabled: True mode: continuous diff --git a/projects/homarr/index.md b/projects/homarr/index.md index 3efac50..9a6bb06 100644 --- a/projects/homarr/index.md +++ b/projects/homarr/index.md @@ -16,8 +16,8 @@ showHero: false # needed to hide "hero banner" ## Docker Compose Example -> [!NOTE] -> For docker support, extend a volume to the docker.sock +> [!NOTE] +> For docker support, extend a volume to the docker.sock > - `/var/run/docker.sock:/var/run/docker.sock` ```yaml diff --git a/projects/homepage/index.md b/projects/homepage/index.md index f4ef92c..a83c5e7 100644 --- a/projects/homepage/index.md +++ b/projects/homepage/index.md @@ -17,7 +17,7 @@ Unlike other dashboards that require complex databases or heavy backend services ``` yaml # homepage - docker compose ---- +--- services: homepage: container_name: homepage diff --git a/projects/jellyfin/index.md b/projects/jellyfin/index.md index 2d133ff..76c01b9 100644 --- a/projects/jellyfin/index.md +++ b/projects/jellyfin/index.md @@ -14,7 +14,7 @@ online accounts and lets you serve up your movies, tv shows and music. Is very similar to apps like Plex and Emby. You can manage your media and auto download things like episode names, artwork etc. Has plugin support and is basically trying to be a better open source version of Plex. It has apps/support for -android, google tvs, firestick, iphone etc. +android, google tvs, firestick, iphone etc. ## Docker Compose Example @@ -40,7 +40,7 @@ services: restart: unless-stopped ``` -> [!NOTE] +> [!NOTE] > Recomend storing the metadata & cache on NAS and not on the OS docker host. The files start to get LARGE for jellyfin due to mass amount of metadata stored for media. Set this under the jellyfin `general` settings after jellyfin is @@ -49,4 +49,4 @@ running. {.is-warning} Once you server is running, head over to the to your opened port (docker_container_ip:8096) to start the setup proccess. When adding libraries - select the content type, set the display name and then click the FOLDERS + option. This is where you will select the path to your media that you set up in -the volumes. +the volumes. diff --git a/projects/linkstack/index.md b/projects/linkstack/index.md index 5435366..cba9870 100644 --- a/projects/linkstack/index.md +++ b/projects/linkstack/index.md @@ -11,7 +11,7 @@ showHero: false # needed to hide "hero banner" `Linkstacks` is a nice little linktr.ee clone that allows you to set up a simple link page. It can also be expanded to add multiple users and you can host -multiple people's pages with their own user accounts and everything. +multiple people's pages with their own user accounts and everything. ## Docker Compose Example diff --git a/projects/mkdocs/index.md b/projects/mkdocs/index.md index f7756e2..cdea6b9 100644 --- a/projects/mkdocs/index.md +++ b/projects/mkdocs/index.md @@ -14,9 +14,9 @@ MkDocs is a fast, simple, and extensible static site generator geared specifical ## Docker Compose Example Running mkdocs with [material](https://squidfunk.github.io/mkdocs-material/) -theme and plugins built in. +theme and plugins built in. -> [!INFO] +> [!INFO] > There is some setup of folders and things that are not automatic so wont work straight out of the box. @@ -35,7 +35,7 @@ services: #- /mnt/store/app/mkdocs/:/docs - docs_nfs:/docs stdin_open: true - tty: true + tty: true ports: - "9896:8000" diff --git a/projects/nginx-proxy-manager/index.md b/projects/nginx-proxy-manager/index.md index ebf72b2..6239f6b 100644 --- a/projects/nginx-proxy-manager/index.md +++ b/projects/nginx-proxy-manager/index.md @@ -59,7 +59,7 @@ all traffic to nginx. Then based on some rules I have set up I can point that traffic to my internal server. For this I will need a domain name server (DNS) to point to my external IP. -### DNS +## DNS A domain name server (DNS) allows me to make a name that can be easily looked up and point traffic to an Internet Protocol (IP) address that a server can easily diff --git a/projects/portainer/index.md b/projects/portainer/index.md index be8765f..6cf2f4b 100644 --- a/projects/portainer/index.md +++ b/projects/portainer/index.md @@ -37,7 +37,7 @@ edit and deploy docker-compose files via the "stacks" page. ``` bash root@server:~# docker ps - CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES + CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES de5b28eb2fa9 portainer/portainer-ce:latest "/portainer" 2 weeks ago Up 9 days 0.0.0.0:8000->8000/tcp, :::8000->8000/tcp, 0.0.0.0:9443->9443/tcp, :::9443->9443/tcp portainer ``` diff --git a/projects/qbittorent/index.md b/projects/qbittorent/index.md index 436317b..01f2505 100644 --- a/projects/qbittorent/index.md +++ b/projects/qbittorent/index.md @@ -13,13 +13,13 @@ showHero: false # needed to hide "hero banner" container. I use QBittorrent because I can set it up with a VPN that only connects via the container directly. Effectively separating it from the rest of my network and allowing me to continue as normal while it is downloading. It -will automatically stop the network if the VPN is not functioning correctly. +will automatically stop the network if the VPN is not functioning correctly. ## Docker Compose Example ``` yaml # qbittorrentvpn - docker compose -# https://hub.docker.com/r/dyonr/qbittorrentvpn +## https://hub.docker.com/r/dyonr/qbittorrentvpn --- version: "2" services : @@ -37,10 +37,10 @@ services : ports : - 8080:8080 - 8999:8999 - - 8999:8999/udp + - 8999:8999/udp volumes : - /app/QBittorrent/config:/config - - /mnt/store/MediaServer/torrent:/downloads + - /mnt/store/MediaServer/torrent:/downloads restart: unless-stopped ``` To set up the VPN you will need to have an existing account with a VPN service. @@ -49,13 +49,14 @@ In my case I use Surfshark and have to go log into my account, navigate to the linux setup page and grab my generated Username key and Password key there. A credentials file on my docker host was generated by QBittorrent when running -the first time. +the first time. + ``` -# download all availble server conf +## download all availble server conf sudo wget https://my.surfshark.com/vpn/api/v1/server/configurations -# cp the server you want to use into config folder -/app/QBittorrent/config/openvpn +## cp the server you want to use into config folder +/app/QBittorrent/config/openvpn ``` Once you restart your qbittorrentvpn docker container you can test your vpn diff --git a/projects/uptime-kuma/index.md b/projects/uptime-kuma/index.md index bc8ed85..0872027 100644 --- a/projects/uptime-kuma/index.md +++ b/projects/uptime-kuma/index.md @@ -12,14 +12,14 @@ showHero: false # needed to hide "hero banner" `uptime-kuma` is a neat little web monitoring application. Lotta dope things right out of the box, very gui / user friendly. Pretty much just add the stack, update the dir for config - and it works. Integrates with discord webhooks, great easy -status page and dashboard. +status page and dashboard. ## Docker Compose Example ```yaml # uptime-kuma - docker compose --- -# https://github.com/louislam/uptime-kuma/wiki/%F0%9F%94%A7-How-to-Install +## https://github.com/louislam/uptime-kuma/wiki/%F0%9F%94%A7-How-to-Install version: '3.3' services: uptime-kuma: diff --git a/projects/wikijs/index.md b/projects/wikijs/index.md index 6428997..b3145f5 100644 --- a/projects/wikijs/index.md +++ b/projects/wikijs/index.md @@ -13,13 +13,13 @@ Wiki.js is a powerful, modern, and open-source wiki application built on Node.js I like it because of the useful Markdown editor that lets you nicely organize links, code etc. I can also backup the database to my NAS in nice MD files, so -nothing gets lost if something is corrupted. +nothing gets lost if something is corrupted. ## Docker Compose Example ``` yaml # wikijs - docker compose -# https://github.com/linuxserver/docker-wikijs +## https://github.com/linuxserver/docker-wikijs --- version: "3.8" services: diff --git a/resume.md b/resume.md index 01f9751..38af173 100644 --- a/resume.md +++ b/resume.md @@ -91,7 +91,7 @@ tags: Work Experience Continued - + Operations Engineer - Inc. Apr 2015 - Sep 2017 @@ -127,7 +127,7 @@ tags: Pennridge High School 2004 - 2009 - + Georgia State University - Computer Science 2012 - 2017 @@ -138,7 +138,7 @@ tags: Skills Certificates - +
    diff --git a/stream/stream_settings.md b/stream/stream_settings.md index 4db2b66..9fdd1e0 100644 --- a/stream/stream_settings.md +++ b/stream/stream_settings.md @@ -13,7 +13,7 @@ lastmod: 2025-02-04 ``` Ignore stream service settings -Video Encoder +Video Encoder x264 1920x1080 Rate control