<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Grant McLravy</title><description>Grant McLravy&apos;s Personal Blog</description><link>https://grantmclravy.com/</link><item><title>Personal Site Redesign</title><link>https://grantmclravy.com/blog/2026/11/21/site-redesign/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2026/11/21/site-redesign/</guid><description>It&apos;s about time for my site to have a bigger redesign.</description><pubDate>Sat, 21 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;It’s about time for my site to have a bigger redesign.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;p&gt;Previously, I switched from &lt;a href=&quot;https://squidfunk.github.io/mkdocs-material/&quot;&gt;MkDocs Material&lt;/a&gt; to &lt;a href=&quot;https://zensical.org/&quot;&gt;Zensical&lt;/a&gt; a couple months ago after the developers announced deprecation of MkDocs Material. I had been waiting for feature parity; I had to wait for the blog feature to exist before switching over. It was a pretty seamless transition, especially using &lt;a href=&quot;https://openrouter.ai/anthropic/claude-opus-5.5&quot;&gt;Claude Opus 5.5&lt;/a&gt; to orchestrate deployment. However, I yearned for the bigger site redesign.&lt;/p&gt;
&lt;p&gt;Playing with an &lt;a href=&quot;https://astro.build&quot;&gt;Astro&lt;/a&gt; site for &lt;a href=&quot;https://grantmclravy.com/blog/2026/11/01/dew-db/&quot;&gt;DewDB&lt;/a&gt; convinced me that with AI design assistance, I could have the personal site of my dreams. It took around 10 design passes before I found something that I liked. Claude was coming up with gimmick sites. I think the design certainly has that &lt;a href=&quot;https://grantmclravy.com/ai/&quot;&gt;sloppy&lt;/a&gt; vibe to it, but it works for me.&lt;/p&gt;
&lt;h2 id=&quot;new-features&quot;&gt;New Features&lt;/h2&gt;
&lt;p&gt;This new site has a few cool new features that I’m excited about:&lt;/p&gt;
&lt;h3 id=&quot;slashpages&quot;&gt;/slashpages&lt;/h3&gt;
&lt;p&gt;The &lt;a href=&quot;https://indieweb.org&quot;&gt;IndieWeb&lt;/a&gt; community promotes something called &lt;a href=&quot;https://slashpages.net&quot;&gt;/slashpages&lt;/a&gt;. They’re a set of predefined pages that can express things that matter to you. I’m implementing these pages:&lt;/p&gt;
&lt;h4 id=&quot;ai&quot;&gt;/ai&lt;/h4&gt;
&lt;p&gt;&lt;a href=&quot;https://grantmclravy.com/ai/&quot;&gt;/ai&lt;/a&gt; is my AI policy, adapted from my &lt;a href=&quot;https://grantmclravy.com/blog/2026/10/01/slop/&quot;&gt;post about AI usage on this site&lt;/a&gt;&lt;/p&gt;
&lt;h4 id=&quot;about&quot;&gt;/about&lt;/h4&gt;
&lt;p&gt;&lt;a href=&quot;https://grantmclravy.com/about/&quot;&gt;/about&lt;/a&gt; used to be the index page of my personal site - now moved to the about page after the redesign. Index is now a rollup of all the content.&lt;/p&gt;
&lt;h4 id=&quot;changelog&quot;&gt;/changelog&lt;/h4&gt;
&lt;p&gt;&lt;a href=&quot;https://grantmclravy.com/changelog/&quot;&gt;/changelog&lt;/a&gt; is a list of changes for the site.&lt;/p&gt;
&lt;h4 id=&quot;chipotle&quot;&gt;/chipotle&lt;/h4&gt;
&lt;p&gt;&lt;a href=&quot;https://grantmclravy.com/chipotle/&quot;&gt;/chipotle&lt;/a&gt; contains my typical Chipotle order&lt;/p&gt;
&lt;h4 id=&quot;contact&quot;&gt;/contact&lt;/h4&gt;
&lt;p&gt;&lt;a href=&quot;https://grantmclravy.com/contact/&quot;&gt;/contact&lt;/a&gt; is something I had previously on the old site and it’s unchanged in the new version. If you want to contact me, the self-hosted &lt;a href=&quot;https://github.com/ohmyform/ohmyform&quot;&gt;OhMyForm&lt;/a&gt;-based form still works for now, at least until I switch to &lt;a href=&quot;https://github.com/formbricks/formbricks&quot;&gt;Formbricks&lt;/a&gt;.&lt;/p&gt;
&lt;h4 id=&quot;podroll&quot;&gt;/podroll&lt;/h4&gt;
&lt;p&gt;&lt;a href=&quot;https://grantmclravy.com/podroll/&quot;&gt;/podroll&lt;/a&gt; is a list of my typical podcast lineup. Yes, I know I listen to too many podcasts.&lt;/p&gt;
&lt;h4 id=&quot;slashes&quot;&gt;/slashes&lt;/h4&gt;
&lt;p&gt;&lt;a href=&quot;https://grantmclravy.com/slashes/&quot;&gt;/slashes&lt;/a&gt; is a complete list of slashpages, inspired by &lt;a href=&quot;https://danq.me/slashes/&quot;&gt;Dan Q’s page of the same name&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;I’m planning on adding more slash pages soon, as inspiration strikes.&lt;/p&gt;
&lt;h3 id=&quot;games-pages&quot;&gt;Games Pages&lt;/h3&gt;
&lt;p&gt;If you select &lt;a href=&quot;https://grantmclravy.com/games/&quot;&gt;games&lt;/a&gt; from the top navbar, you can see my thoughts and most recently played games. I only have a few of my favorite games added so far but I plan on adding more. The eventual goal is a complete inventory of the video games I’ve played.&lt;/p&gt;
&lt;p&gt;There’s also an &lt;a href=&quot;https://grantmclravy.com/games/feed.xml&quot;&gt;RSS feed&lt;/a&gt; and a &lt;a href=&quot;https://grantmclravy.com/games/feed.json&quot;&gt;JSON feed&lt;/a&gt; for the games pages separate from the post feeds.&lt;/p&gt;
&lt;h2 id=&quot;blog-philosophy-shift&quot;&gt;Blog Philosophy Shift&lt;/h2&gt;
&lt;p&gt;As I move into the new era of this personal site, I want to shift my philosophy on the way I publish to the blog. Previously, I had been pretty rigid on my mental concept of what a blog post is. If something isn’t good enough to finish it all the way through and tie it up with a bow, I wouldn’t publish it.&lt;/p&gt;
&lt;p&gt;I want to lower my standards. This blog’s purpose is personal expression. I think I’m going to use GrantMcLravy.com as a way to demonstrate web development / web publishing as a form of play.&lt;/p&gt;
&lt;p&gt;Consequently - this should absolutely be fun! I want to keep it goofier, lighter, less “here’s my organized thoughts in a paragraph” and more “here’s who I am”.&lt;/p&gt;
&lt;p&gt;I don’t know if anyone reads this blog - and I don’t want to have trackable statistics - but I don’t care. I’m enjoying it, and that’s enough for me.&lt;/p&gt;
&lt;p&gt;Welcome to a new era of GrantMcLravy.com!&lt;/p&gt;
</content:encoded><category>Personal</category><category>AI</category><category>Development</category><category>Slop</category><category>slop</category><category>ai</category><category>claude</category><category>blog</category><category>website</category><category>personal-site</category><category>video-games</category></item><item><title>Dew DB</title><link>https://grantmclravy.com/blog/2026/11/01/dew-db/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2026/11/01/dew-db/</guid><description>I have a large collection of Mountain Dew cans. Wanna see?</description><pubDate>Sun, 01 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;I have a large collection of Mountain Dew cans. &lt;a href=&quot;https://dew.grantmclravy.com&quot;&gt;Wanna see&lt;/a&gt;?&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/dew-db-sample.png.webp&quot; width=&quot;1200&quot; height=&quot;1083&quot; alt=&quot;Dew DB interface&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/dew-db-sample.png&quot;&gt;&lt;/p&gt;
&lt;!-- more --&gt;
&lt;h2 id=&quot;background&quot;&gt;Background&lt;/h2&gt;
&lt;p&gt;I have been a fan of Mountain Dew since I was 13 years old. Growing up, I never was a soda drinker. Only when my middle school soccer team banned players from drinking soda did the allure of the syrupy magic elixir grab me. Dew was my poison of choice - the citrusy flavor was more approachable to this late bloomer in the soda-consuming world compared to the sharp and bitter cola.&lt;/p&gt;
&lt;p&gt;Dew then became a core part of my personal brand as a kid. It was a great time to be a Dew fan. There were constant new releases, marketing campaigns, and cultural events. I even took a vacation to Mountain City, TN to get an opportunity to taste new flavors of Dew at the &lt;a href=&quot;https://www.foodandwine.com/news/mtn-dew-outpost-lodge-doe-mountain-tennessee&quot;&gt;Mtn Dew Outpost&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;the-project&quot;&gt;The Project&lt;/h2&gt;
&lt;p&gt;I now have quite the sizable collection of Dews. In 2023, I started a project to catalogue the cans on my shelf in a database that would publish to a read-only API. It started as a Django application with a web interface I could access on my phone, getting the data onto a SQLite DB on my server. At the time, I was using Django at work, so it was an extension of what was familiar.  I catalogued exactly three flavors using this method. It was a pain, and the fun part of the project was building and imagining, not cataloguing.&lt;/p&gt;
&lt;h2 id=&quot;the-slop&quot;&gt;The Slop&lt;/h2&gt;
&lt;p&gt;This project sat on the shelf (ha!) for about three years before I wanted to pick it back up. I had written the original 2023 code by hand. This past year, I have gotten into agentic development (the term people use who are too ashamed to admit that they &lt;a href=&quot;https://grantmclravy.com/blog/2026/10/01/slop/&quot;&gt;vibecoded&lt;/a&gt; something) and wanted to try to revive Dew DB.&lt;/p&gt;
&lt;p&gt;The first prototype existed pretty quickly from just a few simple Claude Code prompts, but the process of getting data loaded for my collection was a pain. This wasn’t something where I was inputting data from a spreadsheet - the data didn’t exist. I chose to create a special mobile app specifically for data input. Keeping in line with my other vibecoded projects, the mobile version was created using Google’s &lt;a href=&quot;https://flutter.dev&quot;&gt;Flutter&lt;/a&gt; framework. The read-only API needed to be scope-expanded to a permissioned read-write API. I handled permissions using Microsoft’s Entra ID. Following the &lt;a href=&quot;https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-configure-app-expose-web-apis&quot;&gt;docs&lt;/a&gt; to expose a Write permission to only specific users in my Microsoft tenant allowed me to enforce read-only by default.&lt;/p&gt;
&lt;p&gt;I chose the UPC barcode on the can as a good identifier in the cataloguing app and got to work scanning about 90 cans on my shelf. Earlier, I had mentally estimated I had about 40 different flavors. One value of the database was quantifying just how big my collection had become!&lt;/p&gt;
&lt;p&gt;Information about the Dews I don’t have on my shelf comes from the &lt;a href=&quot;https://mountaindew.fandom.com/wiki/Mountain_Dew_Wiki&quot;&gt;Dew Fandom wiki&lt;/a&gt;. Fandom, despite their many flaws, licenses their wikis as &lt;a href=&quot;https://creativecommons.org/licenses/by-sa/3.0/&quot;&gt;CC-BY-SA&lt;/a&gt;. I’m able to use this data for this purpose as long as I attribute the wiki as the source.&lt;/p&gt;
&lt;h2 id=&quot;the-frontend&quot;&gt;The Frontend&lt;/h2&gt;
&lt;p&gt;The original interface was a simple table view.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/dew-db-frontend-original.png.webp&quot; width=&quot;1200&quot; height=&quot;1136&quot; alt=&quot;Dew DB frontend interface&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/dew-db-frontend-original.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Dew DB’s frontend is an Astro static site that retrieves the list of Dews at build time using the API. The frontend does not do any GET requests to the API during browsing - only during the build.&lt;/p&gt;
&lt;p&gt;I asked &lt;a href=&quot;https://www.anthropic.com/news/claude-design-anthropic-labs&quot;&gt;Claude Design&lt;/a&gt; to give me three options for the frontend.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/facts-panel-frontend.png.webp&quot; width=&quot;1200&quot; height=&quot;1261&quot; alt=&quot;Facts Panel Frontend&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/facts-panel-frontend.png&quot;&gt;
It called this one &lt;em&gt;The Facts Panel&lt;/em&gt;, based on the nutrition label. Cute, but not very practical.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/tasting-notes.png.webp&quot; width=&quot;1200&quot; height=&quot;1609&quot; alt=&quot;Tasting Notes Frontend&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/tasting-notes.png&quot;&gt;
The &lt;em&gt;Tasting Notes&lt;/em&gt; option felt more like a magazine than a database of my collection.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/the-cooler.png.webp&quot; width=&quot;1200&quot; height=&quot;1549&quot; alt=&quot;The Cooler frontend&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/the-cooler.png&quot;&gt;
&lt;em&gt;The Cooler&lt;/em&gt; is the option I selected.  It’s supposed to emulate the shelves of a gas station fridge. It also includes a denser list view:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/cooler-list-view.png.webp&quot; width=&quot;1200&quot; height=&quot;1075&quot; alt=&quot;The Cooler list view&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/cooler-list-view.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;There is also a ranked view that brings the can art/representation and the tagline to the forefront with a larger score.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/cooler-ranked-view.png.webp&quot; width=&quot;1200&quot; height=&quot;1078&quot; alt=&quot;The Cooler ranked view&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/cooler-ranked-view.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Notice that there are community reviews - if you so desire, you can leave a review for any of the flavors I have listed in the collection. This is the frontend’s only live API request. After a sign-in using &lt;a href=&quot;https://firebase.google.com/docs/auth&quot;&gt;Firebase Auth&lt;/a&gt;, it issues a POST request to the backend API with the review details. All posts are moderated before publication. I also use &lt;a href=&quot;https://www.cloudflare.com/products/turnstile/&quot;&gt;Cloudflare Turnstile&lt;/a&gt; as my bot prevention tool.&lt;/p&gt;
&lt;h2 id=&quot;dewbot&quot;&gt;DewBot&lt;/h2&gt;
&lt;p&gt;I also created a Mastodon bot named &lt;a href=&quot;https://mastodon.granto.cloud/@dewbot&quot;&gt;DewBot&lt;/a&gt; that announces when anything gets added to the shelf, as well as a daily “Here’s a Dew I have!” post.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/dewbot.png.webp&quot; width=&quot;852&quot; height=&quot;1810&quot; alt=&quot;DewBot Mastodon screengrab&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/dewbot.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Mastodon has a built-in RSS feature. If you want to view my Mountain Dew collection in a feed reader, that is a supported workflow.&lt;/p&gt;
&lt;h2 id=&quot;supremely-cool-supremely-useless&quot;&gt;Supremely Cool; Supremely Useless&lt;/h2&gt;
&lt;p&gt;This is a pointless project that I have very much enjoyed. Why care about tracking a sugar water brand container collection enough to have a web API tracking its completeness? Simply because I can. It’s “software development” as a form of play.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://grantmclravy.com/blog/2026/10/01/slop/&quot;&gt;Vibecoding&lt;/a&gt; has reduced the time cost of software development and the amount of effort. I get to be the “ideas guy” - usually a worthless position - and see the software come to life in front of me. Do I get the same fulfillment or satisfaction out of this project as I would from something I’ve built over time like my home server or my home automation? Absolutely not. However, I’m still having a blast. I’ve dipped my toes into frontend in a way I would have shied away from in the past.&lt;/p&gt;
&lt;p&gt;Check out Dew DB at &lt;a href=&quot;https://dew.grantmclravy.com&quot;&gt;https://dew.grantmclravy.com&lt;/a&gt;. If you’re feeling interactive, leave a review on a flavor. Or just share your feedback - I’m &lt;a href=&quot;https://gran.to/social&quot;&gt;@Granto@mastodon.granto.cloud&lt;/a&gt; in the Fediverse.&lt;/p&gt;
</content:encoded><category>Personal</category><category>Mountain Dew</category><category>Slop</category><category>slop</category><category>ai</category><category>claude</category><category>personal-projects</category><category>dew-db</category></item><item><title>AI Policy</title><link>https://grantmclravy.com/blog/2026/10/01/slop/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2026/10/01/slop/</guid><description>I&apos;ve never had a formal AI policy for this blog, so I wanted to clearly define my thoughts on AI slop and how I&apos;ll use generative artificial intelligence on this blog.</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;I’ve never had a formal AI policy for this blog, so I wanted to clearly define my thoughts on AI slop and how I’ll use generative artificial intelligence on this blog.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;h2 id=&quot;blog-ai-policies&quot;&gt;Blog AI Policies&lt;/h2&gt;
&lt;h3 id=&quot;all-words-in-a-post-are-written-by-a-human&quot;&gt;All words in a post are written by a human&lt;/h3&gt;
&lt;p&gt;I physically typed everything in the body of my blog posts unless explicitly mentioned.&lt;/p&gt;
&lt;p&gt;For example, something on this site that was previously AI generated - the JSON-LD block on the &lt;a href=&quot;https://grantmclravy.com/blog/2025/03/25/recipes-seo/&quot;&gt;Recipe SEO investigation&lt;/a&gt; was generated by GPT from an export of the recipe. The post on &lt;a href=&quot;https://grantmclravy.com/blog/2024/05/22/documentation-2-electric-boogaloo/&quot;&gt;AI-generated home-server documentation&lt;/a&gt; includes explicitly AI-generated documentation.&lt;/p&gt;
&lt;h3 id=&quot;all-ideas-are-mine&quot;&gt;All ideas are mine&lt;/h3&gt;
&lt;p&gt;I don’t want to regurgitate an AI conversation or have AI give me the concept of posts to write. This blog’s entire purpose is to have a space on the public internet to broadcast my personal thoughts.&lt;/p&gt;
&lt;p&gt;You don’t care about my Claude conversations. AI psychosis and the experience of using these chatbots make people confidently spew incorrect things because a slopbot confirms their existing opinions.&lt;/p&gt;
&lt;h3 id=&quot;posts-are-reviewed-for-spelling-and-structure-by-ai&quot;&gt;Posts are reviewed for spelling and structure by AI&lt;/h3&gt;
&lt;p&gt;I have frontier models review my posts for spelling and structural issues before I send them to my human editor. (Hi Mom!) I don’t let the slopbot change items directly - I physically type those changes into &lt;a href=&quot;https://obsidian.md&quot;&gt;Obsidian&lt;/a&gt; after using my human meatbrain to decide if the suggestions are worth it.&lt;/p&gt;
&lt;h2 id=&quot;how-i-use-ai&quot;&gt;How I Use AI&lt;/h2&gt;
&lt;h3 id=&quot;i-use-ai-at-work&quot;&gt;I use AI at work&lt;/h3&gt;
&lt;p&gt;I’m about to draft a post about this - but in my role as an automation developer working in the Microsoft Power Platform, I am using Claude Code every day. I probably haven’t written any Power Fx myself so far this month. I certainly am moving faster because of it, but my feeling of ownership over my work and my job satisfaction has significantly decreased.&lt;/p&gt;
&lt;h3 id=&quot;i-vibecode-things-at-home&quot;&gt;I vibecode things at home&lt;/h3&gt;
&lt;p&gt;I’m currently using leftover Claude tokens to vibecode a podcast app for myself. I’ve played with open-source Chinese models - both self-hosted and cloud-hosted using OpenRouter. A personal favorite coding model for my personal stuff is &lt;a href=&quot;https://openrouter.ai/z-ai/glm-5.3-flash&quot;&gt;GLM 5.3-Flash&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;I also one-shot a migration from &lt;a href=&quot;https://squidfunk.github.io/mkdocs-material/&quot;&gt;MkDocs Material&lt;/a&gt; to &lt;a href=&quot;https://zensical.org/&quot;&gt;Zensical&lt;/a&gt;&lt;sup&gt;&lt;a href=&quot;#user-content-fn-1&quot; id=&quot;user-content-fnref-1&quot; data-footnote-ref aria-describedby=&quot;footnote-label&quot;&gt;1&lt;/a&gt;&lt;/sup&gt; for this blog using &lt;a href=&quot;https://openrouter.ai/anthropic/claude-opus-5.5&quot;&gt;Opus 5.5&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;thoughts&quot;&gt;Thoughts&lt;/h2&gt;
&lt;h3 id=&quot;ai-makes-me-feel-icky&quot;&gt;AI makes me feel icky&lt;/h3&gt;
&lt;p&gt;AI art looks gross. Generative AI is trained on massive intellectual property theft - megacorps yoinked the entire internet without compensating the creators who make the content that makes the models useful. The massive energy costs from the compute required for these beefy models harm the environment. Data centers are being built everywhere in communities that don’t want them, causing strain on the already-fragile electric grid.&lt;/p&gt;
&lt;h3 id=&quot;thinking-about-ai-is-exhausting-and-exciting&quot;&gt;Thinking about AI is exhausting and exciting&lt;/h3&gt;
&lt;p&gt;These opinions are not unique; I still thought it would be valuable for me to put these thoughts out there. AI seems to constantly be the topic of conversation, sucking all the air out of the room. It’s exhausting and exhilarating at the same time. New capabilities are constantly coming out. I vacillate between excitement and dread. As a tech nerd, I still believe these models can be very cool. As someone who enjoys my career making software, I don’t want to live in a world where I just ask a robot to do my role for me.&lt;/p&gt;
&lt;section data-footnotes class=&quot;footnotes&quot;&gt;&lt;h2 class=&quot;sr-only&quot; id=&quot;footnote-label&quot;&gt;Footnotes&lt;/h2&gt;
&lt;ol&gt;
&lt;li id=&quot;user-content-fn-1&quot;&gt;
&lt;p&gt;If you want more info on the reason why, take a look at &lt;a href=&quot;https://fpgmaas.com/blog/collapse-of-mkdocs/&quot;&gt;this post about the collapse of MkDocs&lt;/a&gt;. &lt;a href=&quot;#user-content-fnref-1&quot; data-footnote-backref=&quot;&quot; aria-label=&quot;Back to reference 1&quot; class=&quot;data-footnote-backref&quot;&gt;↩&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;/section&gt;
</content:encoded><category>Personal</category><category>AI</category><category>Slop</category><category>slop</category><category>ai</category><category>claude</category><category>policy</category></item><item><title>Adding Matter Support to my Home Assistant Installation</title><link>https://grantmclravy.com/blog/2025/11/11/hass-matter/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2025/11/11/hass-matter/</guid><description>Matter is a new protocol that should finally unify the smart home. I recently bought some Matter-compatible smart plugs and wanted to integrate them in Home Assistant natively.</description><pubDate>Tue, 11 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Matter is a new protocol that should finally unify the smart home. I recently bought some &lt;a href=&quot;https://www.amazon.com/dp/B0BYGMR4DX&quot;&gt;Matter-compatible smart plugs&lt;/a&gt; and wanted to integrate them in Home Assistant natively.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/hass_plus_matter.png.webp&quot; width=&quot;1200&quot; height=&quot;472&quot; alt=&quot;Home Assistant plus matter&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/hass_plus_matter.png&quot;&gt;&lt;/p&gt;
&lt;!-- more --&gt;
&lt;p&gt;&lt;em&gt;Yes, I did make this graphic in Microsoft Paint.&lt;/em&gt;&lt;/p&gt;
&lt;h2 id=&quot;whats-the-matter&quot;&gt;What’s the Matter?&lt;/h2&gt;
&lt;p&gt;&lt;a href=&quot;https://www.theverge.com/22832127/matter-smart-home-products-thread-wifi-explainer&quot;&gt;Matter&lt;/a&gt; is a local protocol for controlling smart home products - lights, plugs, locks. It can run using WiFi or a specialty protocol for Matter called &lt;a href=&quot;https://en.wikipedia.org/wiki/Thread_(network_protocol)&quot;&gt;Thread&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;home-assistant&quot;&gt;Home Assistant&lt;/h2&gt;
&lt;p&gt;I’m a huge &lt;a href=&quot;https://www.home-assistant.io/&quot;&gt;Home Assistant&lt;/a&gt; fan - it was one of the first things I installed on my server. It’s great at bringing disparate ecosystems together into one usable dashboard. It’s also just really fun to tinker with.&lt;/p&gt;
&lt;p&gt;I run my install in a Docker container (&lt;em&gt;surprise!&lt;/em&gt;). That has introduced additional complications in the past - the recommended home assistant install is either bare metal on something like a &lt;a href=&quot;https://www.raspberrypi.com/&quot;&gt;Raspberry Pi&lt;/a&gt; or buying something like a Home Assistant Green to run Home Assistant OS.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/ha-green-photo-front.jpg.webp&quot; width=&quot;1200&quot; height=&quot;800&quot; alt=&quot;Home Assistant green&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/ha-green-photo-front.jpg&quot;&gt;&lt;/p&gt;
&lt;h2 id=&quot;matter-server&quot;&gt;Matter Server&lt;/h2&gt;
&lt;p&gt;I used the documentation from the &lt;code&gt;python-matter-server&lt;/code&gt; package’s GitHub to install in a Docker container. This process was relatively simple:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;services&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  # python-matter-server&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  matter-server&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;ghcr.io/matter-js/python-matter-server:stable&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;matter-server&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    # Required for mDNS to work correctly&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    network_mode&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;host&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    security_opt&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      # Needed for Bluetooth via dbus&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;apparmor:unconfined&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/home/user/docker/matter-server/data:/data/&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      # Required for Bluetooth via D-Bus&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/run/dbus:/run/dbus:ro&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Right after starting the server, Home Assistant discovered Matter as an available integration:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/hass_matter_discovery.png.webp&quot; width=&quot;338&quot; height=&quot;256&quot; alt=&quot;Matter discovered as available integration&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;/p&gt;
&lt;p&gt;I left the WebSocket configuration as the default:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/matter_websocket.png.webp&quot; width=&quot;391&quot; height=&quot;240&quot; alt=&quot;Default setup for websocket&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;/p&gt;
&lt;p&gt;I received this message to show Matter was successfully set up in Home Assistant. Easy peasy - just following some simple docs.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/matter_configuration_success.png.webp&quot; width=&quot;391&quot; height=&quot;180&quot; alt=&quot;Matter configuration success&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;/p&gt;
&lt;h2 id=&quot;pairing-my-smart-switch&quot;&gt;Pairing My Smart Switch&lt;/h2&gt;
&lt;p&gt;Now it was time to pair these new smart switches to Home Assistant using Matter.&lt;/p&gt;
&lt;p&gt;I went within the Home Assistant app in my phone, and navigated to this new Matter section:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/matter_configuration.png.webp&quot; width=&quot;1080&quot; height=&quot;1138&quot; alt=&quot;New matter section in Home Assistant&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/matter_configuration.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I tapped &lt;code&gt;Add Device&lt;/code&gt;. It asked if this device was already in use or if it was new:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/add_matter_device.png.webp&quot; width=&quot;1080&quot; height=&quot;880&quot; alt=&quot;Add matter device&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/add_matter_device.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I selected new. There was a QR code on a sticker on the side of the smart outlet - I scanned that:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/matter_scan_qr.png.webp&quot; width=&quot;1080&quot; height=&quot;2269&quot; alt=&quot;Scan QR code&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/matter_scan_qr.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;It attempted to check my network:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/matter_network_check.png.webp&quot; width=&quot;1080&quot; height=&quot;1758&quot; alt=&quot;Matter network check&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/matter_network_check.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;Bonus points if you can recognize the game my WiFi network is referencing. Leave a comment on this post … oh wait…&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;I got the following error - the Matter setup wizard couldn’t find my device.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/matter_cant_find.png.webp&quot; width=&quot;1080&quot; height=&quot;2274&quot; alt=&quot;Matter couldn’t find device&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/matter_cant_find.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I tried again, and it continued to error out with a generic “Something went wrong” message:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/matter_failure_message.png.webp&quot; width=&quot;1080&quot; height=&quot;2288&quot; alt=&quot;Something went wrong&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/matter_failure_message.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Home Assistant reported &lt;code&gt;error code 1&lt;/code&gt; when adding the device. Obnoxious.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/matter_unable_to_add.png.webp&quot; width=&quot;1080&quot; height=&quot;939&quot; alt=&quot;Error code 1&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/matter_unable_to_add.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I tried restarting my Home Assistant install, and my matter server container. I even tried temporarily disabling the 5 GHz band on my WiFi after I read that matter devices prefer to connect over just 2.4 GHz.&lt;/p&gt;
&lt;p&gt;I already had the TP-Link Kasa app installed to control some of my other smart bulbs and switches. I was hoping to avoid the Kasa app and completely use just Matter, but with the luck I had so far, it seemed like a necessity. The native app detected and paired the switches instantly - no futzing around with WiFi settings. Kasa immediately prompted for a switch firmware update.&lt;/p&gt;
&lt;p&gt;Finally, after a firmware update, a factory reset, and trying to pair again in Home Assistant, I finally added the switch to Home Assistant using Matter.&lt;/p&gt;
&lt;h2 id=&quot;disappointment&quot;&gt;Disappointment&lt;/h2&gt;
&lt;p&gt;This was a very frustrating experience. A fresh out-of-the-box smart switch with a Matter compatible sticker ideally should pair, no problem. Once in Home Assistant, I was also disappointed with my options to control the switch.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/smart_outlet_matter.png.webp&quot; width=&quot;1040&quot; height=&quot;467&quot; alt=&quot;Smart outlet options when paired via Matter&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/smart_outlet_matter.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I simply had the opportunity to turn the plug on and off, with only one sensor that detects if the firmware is up to date.&lt;/p&gt;
&lt;p&gt;This is that same switch using the native TP-Link integration:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/smart_outlet_kasa.png.webp&quot; width=&quot;581&quot; height=&quot;1357&quot; alt=&quot;Smart outlet options when paired via Kasa&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;/p&gt;
&lt;p&gt;So many more options! Energy management sensors, timers, options to turn off the indicator LED, WiFi signal strength - all things that the switch supports in the native app but absent from the Matter integration.&lt;/p&gt;
&lt;p&gt;In theory, &lt;a href=&quot;https://csa-iot.org/newsroom/matter-1-3-specification-released/&quot;&gt;Matter 1.3&lt;/a&gt; supports energy management features. I bought these specific smart plugs because I saw they had energy readouts in addition to Matter support - I just didn’t read reviews or specs to verify that the energy management features were Matter energy management features. Confused yet? Clearly, so was I.&lt;/p&gt;
&lt;p&gt;Matter fully supports controlling the same device in two places - I have the switch paired via Matter and the Kasa app. I’m able to keep it paired directly to HASS while still using the fuller feature set of the local Kasa integration. It’s just frustrating that Matter support feels like an afterthought.&lt;/p&gt;
&lt;p&gt;Matter, in theory, is something I’m very excited about. It’s a good thing to strive for consistency across vendors and have one protocol that Amazon, Google Home, Apple all support natively. However, Matter is moving at a glacial pace. It seems like every year there’s an announcement with a few new supported device types in the standard, then there’s a wait for smart home gadget makers to manufacture devices compatible with the standard.&lt;/p&gt;
&lt;h2 id=&quot;hope&quot;&gt;Hope&lt;/h2&gt;
&lt;p&gt;For the vast majority of people, a smart outlet just needs to be able to be turned on or off in Google Home. Matter meets those needs, assuming the firmware hiccups are ironed out. Home Assistant is great for tinkerers like me, but I’m not your average consumer.&lt;/p&gt;
&lt;p&gt;There are some very cool things coming down the pike for Matter. &lt;a href=&quot;https://www.ikea.com/global/en/newsroom/retail/the-new-smart-home-from-ikea-matter-compatible-251106/&quot;&gt;IKEA just announced&lt;/a&gt; a whole slew of affordable Matter-compatible smart home products. The 1.5 version of the spec is supposed to finally support cameras. Plus, as Matter becomes the expectation as the primary smart-home standard, the growing pains should subside.&lt;/p&gt;
&lt;p&gt;One last note for my one reader - &lt;em&gt;Hi mom!&lt;/em&gt; - I’m going to try to write a blog post a week until the end of 2025. It’s been a while since I’ve done this type of writing for fun on a consistent basis, and I think it will help me keep my creative writing skills honed. Expect something shortly about the process of implementing a comment system for this blog.&lt;/p&gt;
</content:encoded><category>Home Server</category><category>Personal</category><category>self-hosting</category><category>website</category><category>home-server</category><category>home-assistant</category><category>automation</category><category>home-automation</category></item><item><title>RSS Feeds Still Matter</title><link>https://grantmclravy.com/blog/2025/10/28/rss-feeds-rock/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2025/10/28/rss-feeds-rock/</guid><description>RSS feeds are a dying breed. They bring me back to a simpler time of the Web 2.0 internet - before everything was so commercialized and filled with AI slop. In those days, before modern social media giants controlled the vast majority of…</description><pubDate>Tue, 28 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;RSS feeds are a dying breed. They bring me back to a simpler time of the Web 2.0 internet - before everything was so commercialized and filled with AI slop.&lt;sup&gt;&lt;a href=&quot;#user-content-fn-1&quot; id=&quot;user-content-fnref-1&quot; data-footnote-ref aria-describedby=&quot;footnote-label&quot;&gt;1&lt;/a&gt;&lt;/sup&gt; In those days, before modern social media giants controlled the vast majority of web traffic, the world-wide-web felt more whimsical and personal. RSS enabled you to retrieve other sites’ content and bring them into your own reader, almost like an email inbox of articles.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;h2 id=&quot;what-rss-is&quot;&gt;What RSS Is&lt;/h2&gt;
&lt;p&gt;RSS (Really Simple Syndication) is a web technology that allows websites to structure their content in a standardized format that feed readers accept.&lt;/p&gt;
&lt;p&gt;If you see this handy logo (&lt;img class=&quot;inline&quot; src=&quot;https://grantmclravy.com/blog/images/rss_logo.png&quot; alt=&quot;RSS logo&quot;&gt;) on a website that you encounter when surfin’ the web, you can natively import the feed into your reader app. Simply copy the feed URL that looks like this:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;https://feeds.npr.org/1001/rss.xml&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;then paste it in your reader of choice and voilà - you’ve got copies of the articles in a reader format ready for your consumption.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/npr_in_freshrss.png.webp&quot; width=&quot;1200&quot; height=&quot;353&quot; alt=&quot;NPR feed in FreshRSS&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/npr_in_freshrss.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Fun fact - the standard way to distribute a podcast is actually based on RSS. If I go to the &lt;a href=&quot;https://feeds.megaphone.fm/vergecast&quot;&gt;RSS feed for the Vergecast&lt;/a&gt; in my browser, I can see the raw XML of what a podcast app actually receives.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/vergecast_rss.png.webp&quot; width=&quot;1200&quot; height=&quot;588&quot; alt=&quot;RSS feed XML of the Vergecast&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/vergecast_rss.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Clearly RSS is still a backbone of how the internet functions - but once upon a time it was a nerdy consumer facing technology. What caused this shift?&lt;/p&gt;
&lt;h2 id=&quot;why-rss-died&quot;&gt;Why RSS Died&lt;/h2&gt;
&lt;p&gt;Business models matter on the internet just as much as they matter in the “real world.” Just like I talked about in my &lt;a href=&quot;https://grantmclravy.com/blog/2025/03/25/recipes-seo/&quot;&gt;article about recipes and SEO&lt;/a&gt;, the primary way web publications make money is advertising or referrals. Offering an RSS feed of your full content immediately cuts off one of those revenue sources. If you can get the complete article without loading any annoying ads, it’s a preferable user experience, but utterly unsustainable assuming the publication pays the writer who spends time producing the article.&lt;/p&gt;
&lt;p&gt;Just like modern day venture capital throws money at anything AI, once upon a time “New Media” was the new hotness. Early on, during the “build fast and find a way to make money later” era, web publications would gladly give away their content freely to get more readership. Later, during the “turn this money furnace into a sustainable company” era - aka “&lt;a href=&quot;https://bookshop.org/p/books/enshittification-why-everything-suddenly-got-worse-and-what-to-do-about-it-cory-doctorow/d3f8483b158906ce&quot;&gt;enshittification&lt;/a&gt;” - these feeds were stripped back into just a short summary with a link to the ad-infested article.&lt;/p&gt;
&lt;p&gt;RSS feeds feel like a relic of a bygone internet era. Google killed the most popular feed reader, Google Reader all the way back in 2013. CNN’s RSS feeds unceremoniously stopped working in mid-2023. Centralization of the internet means that platforms like &lt;a href=&quot;https://substack.com/about&quot;&gt;Substack&lt;/a&gt; or email newsletters are the predominant way of accomplishing RSS functionality.&lt;/p&gt;
&lt;p&gt;Social media also changed the primary way that consumers used the internet. Feed readers are inherently a personal medium - sharing articles via Facebook, Twitter, etc. is a far more social experience. The tradeoff of being siloed in a single social media site with infinite content versus interacting with the World Wide Web was one most consumers were willing to make.&lt;/p&gt;
&lt;h2 id=&quot;how-i-use-rss&quot;&gt;How I Use RSS&lt;/h2&gt;
&lt;p&gt;In the modern social-media driven algorithmic world, I see value in self-hosting something to help be more intentional about my media consumption. Rather than have the Google News feed decide what I’ll read, keeping a curated list of RSS feeds in a reader takes the power back. I’m doing things on my own terms - plus, it’s another excuse for me to self-host something!&lt;/p&gt;
&lt;p&gt;I am not yet an RSS power user but I have started an attempt to roll out a feed reader for myself. Back in the day, I myself used to be a big &lt;a href=&quot;https://en.wikipedia.org/wiki/Google_Reader&quot;&gt;Google Reader&lt;/a&gt; fan. In current day, I’ve started to use &lt;a href=&quot;https://freshrss.org&quot;&gt;FreshRSS&lt;/a&gt; as my self-hosted feed reader of choice. It’s a simple to use feed reader that doesn’t look too bad, either!&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/freshrss_look.png.webp&quot; width=&quot;1200&quot; height=&quot;601&quot; alt=&quot;Dashboard of FreshRSS&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/freshrss_look.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I run most of my services &lt;a href=&quot;https://grantmclravy.com/blog/2021/11/20/building-the-ultimate-home-server---part-four---creating-a-docker-framework/&quot;&gt;using Docker&lt;/a&gt;, so it was straightforward to deploy. I did so using this Docker Compose:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;freshrss-db&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;postgres:12-alpine&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;freshrss-db&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  hostname&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;freshrss-db&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  restart&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/home/user/Containers/FreshRSS/db:/var/lib/postgresql/data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  environment&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    POSTGRES_USER&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;freshrss&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    POSTGRES_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;sample_password&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    POSTGRES_DB&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;freshrss&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  dns&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;1.1.1.1&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;freshrss-app&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;freshrss/freshrss:latest&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;freshrss-app&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  hostname&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;freshrss-app&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  restart&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  dns&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;  - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;1.1.1.1&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  ports&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;80:80&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  depends_on&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;freshrss-db&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/home/user/Containers/FreshRSS/data:/var/www/FreshRSS/data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/home/user/Containers/FreshRSS/extensions:/var/www/FreshRSS/extensions&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  environment&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    CRON_MIN&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;*/20&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    TZ&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;America/New_York&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;After going through the initial setup wizard, FreshRSS was a blank slate ready for some feeds.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/blank_slate_freshrss.png.webp&quot; width=&quot;1200&quot; height=&quot;657&quot; alt=&quot;FreshRSS blank slate&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/blank_slate_freshrss.png&quot;&gt;&lt;/p&gt;
&lt;p class=&quot;caption&quot;&gt;Blank FreshRSS interface&lt;/p&gt;
&lt;p&gt;As a Verge subscriber, &lt;img class=&quot;inline&quot; src=&quot;https://grantmclravy.com/blog/images/squidward_dabbing.png&quot; alt=&quot;squidward dabbing&quot;&gt; I was able to import the full-text of articles from the Verge website. That also means that the Verge was being compensated to provide me this content.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/verge_feed_in_freshrss.png.webp&quot; width=&quot;738&quot; height=&quot;1622&quot; alt=&quot;FreshRSS import of the Verge website&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/verge_feed_in_freshrss.png&quot;&gt;&lt;/p&gt;
&lt;p class=&quot;caption&quot;&gt;FreshRSS including articles from the Verge&lt;/p&gt;
&lt;p&gt;This was great for one specific website, but what about other sites that have their content freely available (i.e., no paywall) but had their RSS feed truncated?&lt;sup&gt;&lt;a href=&quot;#user-content-fn-2&quot; id=&quot;user-content-fnref-2&quot; data-footnote-ref aria-describedby=&quot;footnote-label&quot;&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;
&lt;p&gt;A tool called &lt;a href=&quot;https://www.fivefilters.org/full-text-rss/&quot;&gt;Full-Text RSS&lt;/a&gt; from fivefilters.org accepts a truncated RSS feed, goes to the article, parses it, and returns a full text RSS article.&lt;/p&gt;
&lt;p&gt;Here’s another docker container install to get this new shiny up and running:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;fullfeedrss&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;fullfeedrss&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;heussd/fivefilters-full-text-rss:latest&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  environment&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;FTR_ADMIN_PASSWORD=samplepassword&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    -  &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/home/user/Containers/rss-cache:/var/www/html/cache&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  ports&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;80:80&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;I was able to go to the fullfeedrss container where it let me paste in a feed URL:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/full_text_rss.png.webp&quot; width=&quot;1200&quot; height=&quot;1013&quot; alt=&quot;Full text RSS&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/full_text_rss.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Using the same NPR feed from earlier, I pasted it in and let the container do its magic. The new feed &lt;code&gt;https://feed.vpn.gran.to/makefulltextfeed.php?url=sec%3A%2F%2Ffeeds.npr.org%2F1001%2Frss.xml&amp;amp;max=200&amp;amp;links=preserve&amp;amp;exc=&amp;amp;submit=Create+Feed&amp;amp;parser=html5php&lt;/code&gt; included the complete article version of the articles, not just the summaries.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/npr_freshrss_example.png.webp&quot; width=&quot;714&quot; height=&quot;1616&quot; alt=&quot;NPR FreshRSS Example&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/npr_freshrss_example.png&quot;&gt;&lt;/p&gt;
&lt;p class=&quot;caption&quot;&gt;FreshRSS including full article from NPR.org&lt;/p&gt;
&lt;p&gt;I hope to continue curating my RSS feeds, keeping a better relationship with scrolling through the news. Even though RSS feed readers have a familiar design to email inboxes, I don’t want to have the expectation to read every article. The “mark all as read” button is my friend. The goal is to have the option to read media in this environment, not have another chore to clear out a notification number.&lt;/p&gt;
&lt;p&gt;After my experience with the modern web and the implementation of RSS, it made me realize the value of having an RSS feed for this blog.&lt;/p&gt;
&lt;h2 id=&quot;getting-rss-back&quot;&gt;Getting RSS Back&lt;/h2&gt;
&lt;p&gt;When I switched my blog from &lt;a href=&quot;https://grantmclravy.com/blog/2025/03/16/making-my-personal-site-my-own/&quot;&gt;WordPress to Mkdocs Material&lt;/a&gt;, I lost the native support for RSS. WordPress provided some of the &lt;em&gt;creature comforts&lt;/em&gt; of the open web that something designed for code documentation needs some customization to get back. Luckily, Mkdocs Material has a solution to create RSS feeds for the blog plugin using  the &lt;code&gt;mkdocs-rss-plugin&lt;/code&gt; package. I simply had to install it to my blog site:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;pip install mkdocs-rss-plugin&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;I had a few customizations I had to modify in &lt;code&gt;mkdocs.yml&lt;/code&gt;  - the main configuration file for this blog.&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;rss&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  match_path&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;blog/posts/.*&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  use_material_blog&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  abstract_chars_count&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;-1&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  date_from_meta&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    as_creation&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;date&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  categories&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;categories&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;tags&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  use_git&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; &lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;blog&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  post_url_format&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;{date}/{slug}&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;That &lt;code&gt;abstract_chars_count&lt;/code&gt; being set to -1 ensures that my RSS feed is the full text article - no need for fancy containers to parse the full text here. I also have no intention of making money from my personal website, so there’s no risk for me there. I also specifically had to disable the RSS plugin’s git integration due to deploying to Cloudflare pages - I got this error message before disabling it:&lt;/p&gt;
&lt;details class=&quot;callout&quot;&gt;
&lt;summary&gt;Error Message&lt;/summary&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Date&lt;/th&gt;
&lt;th&gt;Message&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.862&lt;/td&gt;
&lt;td&gt;File “/opt/buildhome/.asdf/installs/python/3.11.5/lib/python3.11/site-packages/mkdocs_rss_plugin/plugin.py”, line 138, in on_config&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.862&lt;/td&gt;
&lt;td&gt;self.util = Util(&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.862&lt;/td&gt;
&lt;td&gt;^^^^^&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.862&lt;/td&gt;
&lt;td&gt;File “/opt/buildhome/.asdf/installs/python/3.11.5/lib/python3.11/site-packages/mkdocs_rss_plugin/util.py”, line 125, in &lt;strong&gt;init&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.862&lt;/td&gt;
&lt;td&gt;CiHandler(git_repo.git).raise_ci_warnings()&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.863&lt;/td&gt;
&lt;td&gt;File “/opt/buildhome/.asdf/installs/python/3.11.5/lib/python3.11/site-packages/mkdocs_rss_plugin/git_manager/ci.py”, line 45, in raise_ci_warnings&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.863&lt;/td&gt;
&lt;td&gt;n_commits = self.commit_count()&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.863&lt;/td&gt;
&lt;td&gt;^^^^^^^^^^^^^^^^^^^&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.863&lt;/td&gt;
&lt;td&gt;File “/opt/buildhome/.asdf/installs/python/3.11.5/lib/python3.11/site-packages/mkdocs_rss_plugin/git_manager/ci.py”, line 104, in commit_count&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.863&lt;/td&gt;
&lt;td&gt;refs = [x.split()[0] for x in refs]&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;23:55:21.863&lt;/td&gt;
&lt;td&gt;^^^^^^^^^^^^^^^^^^^^^^^^^^^^&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/details&gt;
&lt;p&gt;This exciting gobbledygook means that it was unable to find a valid Git repo - even though I write this blog in a git repo. However, this repository is not initialized in the Cloudflare environment that deploys the site, so I needed to ensure that &lt;code&gt;use_git: false&lt;/code&gt; was set or else the build would fail.&lt;/p&gt;
&lt;p&gt;Once I successfully set up the plugin, it automatically set up an RSS feed for my site at &lt;a href=&quot;https://grantmclravy.com/feed_rss_created.xml&quot;&gt;https://grantmclravy.com/feed_rss_created.xml&lt;/a&gt; and set up the necessary headers in the &lt;code&gt;&amp;lt;head&amp;gt;&lt;/code&gt; element of my blog.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/header_rss.png.webp&quot; width=&quot;1115&quot; height=&quot;514&quot; alt=&quot;RSS link highlighted in the head tag&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/header_rss.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;From &lt;a href=&quot;https://freshrss.org/index.html&quot;&gt;FreshRSS&lt;/a&gt;, I went to go add this new feed:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/feed_setup.png.webp&quot; width=&quot;822&quot; height=&quot;432&quot; alt=&quot;Image of feed setup in FreshRSS&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/feed_setup.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/feed_setup_2.png.webp&quot; width=&quot;1200&quot; height=&quot;591&quot; alt=&quot;Second image of feed setup in FreshRSS&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/feed_setup_2.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;There was a button to check the validity of the feed, and several things failed the &lt;a href=&quot;https://validator.w3.org/feed/check.cgi?url=https%3A%2F%2Fgrantmclravy.com%2Ffeed_rss_created.xml&quot;&gt;feed validation&lt;/a&gt;:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/feed_validation_failure.png.webp&quot; width=&quot;1200&quot; height=&quot;700&quot; alt=&quot;Failure validating feed&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/feed_validation_failure.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;The feed I was generating wasn’t a valid feed for three reasons:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Image URL was blank - returning as &lt;code&gt;None&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;The author field did not include an email address as required&lt;/li&gt;
&lt;li&gt;There was no “channel element description”&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;For the image URL, I had to add that to my RSS configuration in my &lt;code&gt;mkdocs.yml&lt;/code&gt;:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;rss&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;  [&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  use_git&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;https://grantmclravy.com/images/Headshot.jpg&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; &lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Author field just required me to add an email to my &lt;code&gt;.authors.yml&lt;/code&gt; metadata:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;authors&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  grant&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;Grant McLravy&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    description&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;Grant McLravy&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    avatar&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;https://gravatar.com/avatar/1e12aebdf63d7b9c14d1ca7d06282456770fda7a9f2e3dffd8d18669d9c5ae4a?size=256&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    slug&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;grant&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    url&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;https://grantmclravy.com/&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    email&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;hi@grantmclravy.com&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Setting up the “channel element description” just required updating &lt;code&gt;mkdocs.yml&lt;/code&gt; with a description.&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;site_description&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;Grant McLravy&apos;s Personal Blog&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;After fixing these things, my feed validated. I was able to add it to FreshRSS:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/my_feed_in_freshrss.png.webp&quot; width=&quot;1200&quot; height=&quot;460&quot; alt=&quot;My feed in FreshRSS&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/my_feed_in_freshrss.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;It successfully pulled all of my posts into my feed reader. If you want to do the same, add &lt;a href=&quot;https://grantmclravy.com/feed_rss_created.xml&quot;&gt;this feed&lt;/a&gt; and you will get one or two posts a year to read in your feedbox.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;https://grantmclravy.com/feed_rss_created.xml&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;RSS is not as culturally relevant in the nerd sphere as it was 10-15 years ago, but it’s still a powerful tool for decentralized content consumption. Self-hosting enables keeping these technologies alive even when tech megacorps deem them not worth supporting. Plus, keeping my website custom(ish) means I can be an example of the things I care about.&lt;/p&gt;
&lt;section data-footnotes class=&quot;footnotes&quot;&gt;&lt;h2 class=&quot;sr-only&quot; id=&quot;footnote-label&quot;&gt;Footnotes&lt;/h2&gt;
&lt;ol&gt;
&lt;li id=&quot;user-content-fn-1&quot;&gt;
&lt;p&gt;&lt;em&gt;Side note - all of these blog posts are genuine handwritten slop. I’ll always note things that are AI generated - I’ve updated a few of my older posts with some notes about where I used AI. For example, I used ChatGPT to generate my recipe JSON-LD for my &lt;a href=&quot;https://grantmclravy.com/blog/2025/03/25/recipes-seo/&quot;&gt;recipe post&lt;/a&gt; but the recipe was all me.&lt;/em&gt; &lt;a href=&quot;#user-content-fnref-1&quot; data-footnote-backref=&quot;&quot; aria-label=&quot;Back to reference 1&quot; class=&quot;data-footnote-backref&quot;&gt;↩&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li id=&quot;user-content-fn-2&quot;&gt;
&lt;p&gt;&lt;em&gt;Side note - there should be a separate discussion about the ethics of adblocking.  Reference &lt;a href=&quot;https://en.wikipedia.org/wiki/Linus_Sebastian&quot;&gt;Linus&lt;/a&gt;’s controversial &lt;a href=&quot;https://www.youtube.com/watch?v=a-PH2GUy_zM&quot;&gt;Adblock equals piracy&lt;/a&gt; take&lt;/em&gt; &lt;a href=&quot;#user-content-fnref-2&quot; data-footnote-backref=&quot;&quot; aria-label=&quot;Back to reference 2&quot; class=&quot;data-footnote-backref&quot;&gt;↩&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;/section&gt;
</content:encoded><category>Development</category><category>Home Server</category><category>self-hosting</category><category>website</category><category>blog</category><category>personal-site</category><category>rss</category><category>world-wide-web</category></item><item><title>The Recipe Mafia Hurts the Consumer</title><link>https://grantmclravy.com/blog/2025/03/25/recipes-seo/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2025/03/25/recipes-seo/</guid><description>Did you know Google essentially mandates that recipe sites follow a specific format or else they will not feature your recipe in their search engine? I went down a rabbit hole of food recipe madness after posting my first recipe the other…</description><pubDate>Tue, 25 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Did you know Google essentially mandates that recipe sites follow a specific format or else they will not feature your recipe in their search engine?&lt;/p&gt;
&lt;p&gt;I went down a rabbit hole of food recipe madness after posting my first recipe the other day, and I thought it would be interesting to share the craziness that is recipe SEO.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;h2 id=&quot;mealie-parsing&quot;&gt;Mealie Parsing&lt;/h2&gt;
&lt;p&gt;In my &lt;a href=&quot;https://grantmclravy.com/blog/2025/03/23/hogchiladas/&quot;&gt;previous blog post&lt;/a&gt;, I ended the post talking about how I typically parsed recipes using the &lt;a href=&quot;https://mealie.io&quot;&gt;Mealie&lt;/a&gt; recipe management software. It has a really handy tool that imports a URL and adds the recipe to the database. I noted that I would try to parse my post and update that post with the results.&lt;/p&gt;
&lt;p&gt;When I attempted to import the recipe, I got this error:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/mealie-failed-import.png.webp&quot; width=&quot;643&quot; height=&quot;485&quot; alt=&quot;Only websites containing ld+json can be imported by Mealie&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/mealie-failed-import.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;The links led me down another rabbit hole about the &lt;a href=&quot;https://schema.org/Recipe&quot;&gt;recipe schema&lt;/a&gt; and how &lt;a href=&quot;https://developers.google.com/search/docs/appearance/structured-data/recipe&quot;&gt;Google prefers recipes in that JSON format&lt;/a&gt; for their search results.&lt;/p&gt;
&lt;h2 id=&quot;the-recipe-format&quot;&gt;The Recipe Format&lt;/h2&gt;
&lt;p&gt;Google prefers the recipes to be in &lt;a href=&quot;https://en.wikipedia.org/wiki/JSON-LD&quot;&gt;JSON-LD&lt;/a&gt;, a special JSON format designed for encoding linked data. Embedded in your HTML with a script tag, recipe sites include a machine-readable version of the recipe.&lt;/p&gt;
&lt;p&gt;Here’s my “Hogchiladas” recipe in this JSON-LD format (generated by ChatGPT):&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;@context&quot;: &quot;https://schema.org/&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;@type&quot;: &quot;Recipe&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;name&quot;: &quot;Hogchiladas&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;description&quot;: &quot;A delicious enchilada-style dish made with pork carnitas, cheese, and a creamy green chile sauce.&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;image&quot;: &quot;&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;author&quot;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;@type&quot;: &quot;Person&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;name&quot;: &quot;Grant McLravy&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;datePublished&quot;: &quot;2025-03-23&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;recipeCategory&quot;: [&quot;Dinner&quot;],&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;recipeYield&quot;: &quot;6 servings&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;totalTime&quot;: &quot;PT45M&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;prepTime&quot;: &quot;PT20M&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;cookTime&quot;: &quot;PT25M&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;recipeIngredient&quot;: [&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;1 lb Aldi microwavable pork carnitas&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;5 oz Aldi teriyaki sauce&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;2 cups Monterey Jack / Chihuahua cheese&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;6 taco-sized tortillas&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;5 oz canned Mexican street corn&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;1 bunch fresh cilantro&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;5 oz canned green chiles&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;1 whole large red onion, chopped&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;14 oz chicken broth&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;2 tbsp flour&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;1 cup sour cream&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;French fried onions (for garnish)&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;Real bacon bits&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;4 tbsp unsalted butter&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  ],&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;recipeInstructions&quot;: [&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;@type&quot;: &quot;HowToStep&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;text&quot;: &quot;Preheat oven to 350 degrees.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;@type&quot;: &quot;HowToStep&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;text&quot;: &quot;Sauté chopped onions in butter.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;@type&quot;: &quot;HowToStep&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;text&quot;: &quot;To make sauce, combine 1 cup of sour cream, chiles, and chicken broth. Heat, stir, then add flour to thicken. Do not let boil.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;@type&quot;: &quot;HowToStep&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;text&quot;: &quot;Microwave Aldi pork; add 1/3 of the bottle of teriyaki sauce.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;@type&quot;: &quot;HowToStep&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;text&quot;: &quot;Add in 1/3 a can of street corn, onion, cilantro to meat and mix thoroughly.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;@type&quot;: &quot;HowToStep&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;text&quot;: &quot;Scoop into tortillas; add cheese to inside; roll into greased oven pan.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;@type&quot;: &quot;HowToStep&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;text&quot;: &quot;Top with sauce and additional cheese.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;@type&quot;: &quot;HowToStep&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;text&quot;: &quot;Bake 25 minutes or until cheese is toasted.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;@type&quot;: &quot;HowToStep&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;      &quot;text&quot;: &quot;Top with cilantro, French-fried onions, and bacon bits.&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  ],&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  &quot;nutrition&quot;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;    &quot;@type&quot;: &quot;NutritionInformation&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;It cracks me up to no end that hidden in the recipe page is the readable recipe for the computer, while the human has to slog through stories about the impact of the recipe or the why behind cooking it, all while loading advertisements.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/recipe-webcomic.png.webp&quot; width=&quot;990&quot; height=&quot;990&quot; alt=&quot;webcomic decrying the length of introductions on recipe sites&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/recipe-webcomic.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;A food blogger named &lt;a href=&quot;https://www.barleyandsage.com/our-story/&quot;&gt;Kyleigh Sage&lt;/a&gt; wrote an article titled &lt;a href=&quot;https://www.barleyandsage.com/why-food-bloggers-dont-just-post-the-recipe/&quot;&gt;Why Food Bloggers Don’t Just Post the Recipe&lt;/a&gt; where she discusses the reality behind running an independent food blog. &lt;em&gt;(She also included that Buzzfeed comic above that sparks joy.)&lt;/em&gt; She states the most important reason that food blogs have the long articles discussing the recipe before just including it is because recipe posts are written with Google SEO recommendations in mind.&lt;/p&gt;
&lt;h2 id=&quot;seo-ruins-the-internet&quot;&gt;SEO Ruins the Internet&lt;/h2&gt;
&lt;p&gt;I strongly believe that SEO is actively ruining the internet. Search Engine Optimization is the act of designing your web presence in a way that enables your website to be higher in the search engine ranking. The Verge’s &lt;a href=&quot;https://www.theverge.com/features/23931789/seo-search-engine-optimization-experts-google-results&quot;&gt;article about SEO&lt;/a&gt; by &lt;a href=&quot;https://www.amandachicagolewis.com&quot;&gt;Amanda Chicago Lewis&lt;/a&gt; is one of my favorite articles of all time - the way these SEO consultants see themselves as the hackers decoding the algorithms that control the world cracks me up. In reality, SEO results in the slop that makes the modern web so annoying to navigate.&lt;/p&gt;
&lt;p&gt;SEO is the reason every software as a service company has a page comparing their software to the name brand and ultimately recommending you to use their own software. SEO is the reason that there are 500 word articles for “What Channel is the Super Bowl On” from random sites when the answer is one word - “FOX”. SEO explains the dozens of articles about “When Severance Season 3 Releases” that all have no new information.&lt;/p&gt;
&lt;p&gt;Google is the primary referrer for all traffic on the web. What Google says goes. If Google says that recipe sites need to include a secret code, bloggers would be foolish if they ignored their primary source of eyeballs.&lt;/p&gt;
&lt;h2 id=&quot;google-enables-recipe-scraping&quot;&gt;Google Enables Recipe Scraping&lt;/h2&gt;
&lt;p&gt;I clicked around on Kyleigh’s food blog to find a recipe for an example. I found this lovely &lt;a href=&quot;https://www.barleyandsage.com/baked-mac-cheese/&quot;&gt;Baked Mac &amp;amp; Cheese&lt;/a&gt; recipe.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/mac-and-cheese-recipe.png.webp&quot; width=&quot;700&quot; height=&quot;1366&quot; alt=&quot;Baked Mac &amp;amp; Cheese&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/mac-and-cheese-recipe.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Sure enough, opening the Inspect Element screen, in the &lt;code&gt;&amp;lt;head&amp;gt;&lt;/code&gt; div, there was a &lt;code&gt;JSON-LD&lt;/code&gt;  block that contained the full recipe in this special formatting.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/json-data-mac-and-cheese.png.webp&quot; width=&quot;1200&quot; height=&quot;622&quot; alt=&quot;JSON-LD data for the mac and cheese recipe&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/json-data-mac-and-cheese.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I hopped over to my favorite recipe manager Mealie, and was able to successfully import it immediately from just the URL.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/mealie-mac-and-cheese.png.webp&quot; width=&quot;1200&quot; height=&quot;732&quot; alt=&quot;Recipe imported into mealie&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/mealie-mac-and-cheese.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Because Google needs a machine-readable way to display recipe cards, and Google controls web traffic to recipe sites, I don’t have to read all the fluff in a recipe and immediately import it into my recipe management site without loading the ads.&lt;/p&gt;
&lt;p&gt;I’m one who waxes philosophical on the business model of the internet and the future of how we gather information.  It’s crazy to me that SEO has made recipe sites less readable and human friendly, while making these more parse-able for machines.&lt;/p&gt;
&lt;p&gt;Writers should have the option of being paid for their work. Google should be able to display recipes in a way consumers want to read them. As with most tug-of-war games with a megacorp, the smaller party doesn’t typically win. Food writers need to format their recipes in a specific way, include their keywords, and if they’re lucky they will be rewarded with web traffic.&lt;/p&gt;
&lt;p&gt;Ultimately, I stumbled into the wacky world of recipe SEO after failing to import a recipe from my website into Mealie. I finally added the needed script file to my previous &lt;a href=&quot;https://grantmclravy.com/blog/2025/03/23/hogchiladas/&quot;&gt;Hogchiladas blog post&lt;/a&gt; and was able to scrape it using mealie successfully.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/hogchiladas-mealie.png.webp&quot; width=&quot;1200&quot; height=&quot;743&quot; alt=&quot;Mealie hogchiladas&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/hogchiladas-mealie.png&quot;&gt;&lt;/p&gt;
</content:encoded><category>Personal</category><category>Big Tech</category><category>Home Server</category><category>cooking</category><category>recipe</category><category>personal-site</category><category>blog</category><category>self-hosting</category><category>home-server</category></item><item><title>Hogchiladas</title><link>https://grantmclravy.com/blog/2025/03/23/hogchiladas/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2025/03/23/hogchiladas/</guid><description>Normally, a recipe post would start with a 1500-word explanation of a recipe and its origin. I don&apos;t believe in wasting your time for SEO purposes, so here&apos;s the recipe. If you want the why, read on afterwards.</description><pubDate>Sun, 23 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Normally, a recipe post would start with a 1500-word explanation of a recipe and its origin. I don’t believe in wasting your time for SEO purposes, so here’s the recipe. If you want the why, read on afterwards.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;h2 id=&quot;hogchiladas&quot;&gt;Hogchiladas&lt;/h2&gt;
&lt;h3 id=&quot;ingredients&quot;&gt;Ingredients&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;One lb. Aldi microwavable pork carnitas&lt;/li&gt;
&lt;li&gt;5 oz. Aldi teriyaki sauce&lt;/li&gt;
&lt;li&gt;2 cups Monterey Jack / Chihuahua cheese&lt;/li&gt;
&lt;li&gt;6 taco-sized tortillas&lt;/li&gt;
&lt;li&gt;5 oz. canned Mexican street corn&lt;/li&gt;
&lt;li&gt;1 bunch fresh cilantro&lt;/li&gt;
&lt;li&gt;5 oz. canned green chiles&lt;/li&gt;
&lt;li&gt;1 whole large red onion, chopped&lt;/li&gt;
&lt;li&gt;14 oz. chicken broth&lt;/li&gt;
&lt;li&gt;2 tbsp. flour&lt;/li&gt;
&lt;li&gt;1 cup sour cream&lt;/li&gt;
&lt;li&gt;French fried onions (for garnish)&lt;/li&gt;
&lt;li&gt;Real bacon bits&lt;/li&gt;
&lt;li&gt;4 tbsp. unsalted butter&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;instructions&quot;&gt;Instructions&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;Preheat oven to 350 degrees.&lt;/li&gt;
&lt;li&gt;Sauté chopped onions in butter.&lt;/li&gt;
&lt;li&gt;To make sauce, combine 1 cup of sour cream, chiles, and chicken broth. Heat, stir, then add flour to thicken. Do not let boil.&lt;/li&gt;
&lt;li&gt;Microwave Aldi pork; add 1/3 of the bottle of teriyaki sauce.&lt;/li&gt;
&lt;li&gt;Add in 1/3 a can of street corn, onion, cilantro to meat and mix thoroughly.&lt;/li&gt;
&lt;li&gt;Scoop into tortillas; add cheese to inside; roll into greased oven pan.&lt;/li&gt;
&lt;li&gt;Top with sauce and additional cheese.&lt;/li&gt;
&lt;li&gt;Bake 25 minutes or until cheese is toasted.&lt;/li&gt;
&lt;li&gt;Top with cilantro, French-fried onions, and bacon bits.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;the-why-behind-the-hogchiladas&quot;&gt;The Why behind the Hogchiladas&lt;/h2&gt;
&lt;p&gt;Enchiladas are currently one of the few dishes I regularly cook. I typically use a very simple beef enchilada recipe - 6 ingredients (beef, taco seasoning, tortilla, cheddar cheese, canned red enchilada sauce, green chiles) and a little bit of time in the oven, and it’s ready to serve. I typically don’t push myself to try new recipes, but inspiration struck when I tried a taco from taco chain Torchy’s Tacos. They introduced a taco of the month called “&lt;a href=&quot;https://torchystacos.com/food/the-hogfather/&quot;&gt;The Hogfather&lt;/a&gt;,” and it was glorious.
&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/hogfather.png.webp&quot; width=&quot;1200&quot; height=&quot;455&quot; alt=&quot;Image of hogfather taco from the Torchy’s taco website&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/hogfather.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I based my Hogchilada recipe on this taco - with the sweet teriyaki pork flavor contrasted with the salty bacon, onion and the white enchilada sauce. I wanted the primary flavor to be teriyaki rather than chile, and I think the recipe turned out better than I could have hoped.&lt;/p&gt;
&lt;h2 id=&quot;this-isnt-home-server-content&quot;&gt;This isn’t home server content&lt;/h2&gt;
&lt;p&gt;I know this is outside my typical blog content about my home server, so if you’re a nerd that prefers that, here’s a little rundown on a cool self-hosted recipe management tool called &lt;a href=&quot;https://mealie.io&quot;&gt;Mealie&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Mealie is a web-based recipe database that allows me to import web-based recipes, parse them, and keep the recipes for posterity. Mealie can then create meal plans and shopping lists based on the ingredients for these recipes. It’s a very handy little web app. It requires setup of a database - I use postgres.&lt;/p&gt;
&lt;p&gt;Here’s a sample docker compose you can use to spin up your own instance of mealie. Make sure to change credentials where appropriate.&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt; mealie&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;mealie&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;hkotel/mealie:latest&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;80:80&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      PUID&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;1000&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      PGID&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;1000&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      TZ&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;America/New_York&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      RECIPE_PUBLIC&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;true&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      RECIPE_SHOW_NUTRITION&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;true&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      RECIPE_SHOW_ASSETS&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;true&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      RECIPE_LANDSCAPE_VIEW&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;true&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      RECIPE_DISABLE_COMMENTS&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;false&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      RECIPE_DISABLE_AMOUNT&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;false&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_ENGINE&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;postgres&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      POSTGRES_USER&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;mealie&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      POSTGRES_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;mealie&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      POSTGRES_SERVER&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;mealie&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      POSTGRES_PORT&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;5432&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      POSTGRES_DB&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;mealie&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/home/user/Containers/mealie/data/:/app/data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt; mealie_postgres&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;mealie_postgres&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;postgres:14&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;always&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      POSTGRES_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;mealie&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      POSTGRES_USER&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;mealie&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      POSTGRES_DB&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;mealie&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/home/user/Containers/mealie/db:/var/lib/postgresql/data&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Once this blog post is published to the public internet, I am going to test Mealie’s ability to scrape my own recipe and will update this post accordingly.&lt;/p&gt;
&lt;aside class=&quot;callout callout-note&quot;&gt;
&lt;p class=&quot;callout-title&quot;&gt;Update&lt;/p&gt;
&lt;p&gt;I failed to scrape this recipe initially, but learned a ton about the weird world of recipe SEO in my &lt;a href=&quot;https://grantmclravy.com/blog/2025/03/25/recipes-seo/&quot;&gt;next blogpost&lt;/a&gt;. I eventually was able to scrape this recipe successfully.&lt;/p&gt;
&lt;/aside&gt;
&lt;script type=application/ld+json class=hogchiladas-recipe&gt;
{
  &quot;@context&quot;: &quot;https://schema.org/&quot;,
  &quot;@type&quot;: &quot;Recipe&quot;,
  &quot;name&quot;: &quot;Hogchiladas&quot;,
  &quot;description&quot;: &quot;A delicious enchilada-style dish made with pork carnitas, cheese, and a creamy green chile sauce.&quot;,
  &quot;author&quot;: {
    &quot;@type&quot;: &quot;Person&quot;,
    &quot;name&quot;: &quot;Grant McLravy&quot;
  },
  &quot;datePublished&quot;: &quot;2025-03-23&quot;,
  &quot;recipeCategory&quot;: [&quot;Dinner&quot;],
  &quot;recipeYield&quot;: &quot;6 servings&quot;,
  &quot;totalTime&quot;: &quot;PT45M&quot;,
  &quot;prepTime&quot;: &quot;PT20M&quot;,
  &quot;cookTime&quot;: &quot;PT25M&quot;,
  &quot;recipeIngredient&quot;: [
    &quot;1 lb Aldi microwavable pork carnitas&quot;,
    &quot;5 oz Aldi teriyaki sauce&quot;,
    &quot;2 cups Monterey Jack / Chihuahua cheese&quot;,
    &quot;6 taco-sized tortillas&quot;,
    &quot;5 oz canned Mexican street corn&quot;,
    &quot;1 bunch fresh cilantro&quot;,
    &quot;5 oz canned green chiles&quot;,
    &quot;1 whole large red onion, chopped&quot;,
    &quot;14 oz chicken broth&quot;,
    &quot;2 tbsp flour&quot;,
    &quot;1 cup sour cream&quot;,
    &quot;French fried onions (for garnish)&quot;,
    &quot;Real bacon bits&quot;,
    &quot;4 tbsp unsalted butter&quot;
  ],
  &quot;recipeInstructions&quot;: [
    {
      &quot;@type&quot;: &quot;HowToStep&quot;,
      &quot;text&quot;: &quot;Preheat oven to 350 degrees.&quot;
    },
    {
      &quot;@type&quot;: &quot;HowToStep&quot;,
      &quot;text&quot;: &quot;Sauté chopped onions in butter.&quot;
    },
    {
      &quot;@type&quot;: &quot;HowToStep&quot;,
      &quot;text&quot;: &quot;To make sauce, combine 1 cup of sour cream, chiles, and chicken broth. Heat, stir, then add flour to thicken. Do not let boil.&quot;
    },
    {
      &quot;@type&quot;: &quot;HowToStep&quot;,
      &quot;text&quot;: &quot;Microwave Aldi pork; add 1/3 of the bottle of teriyaki sauce.&quot;
    },
    {
      &quot;@type&quot;: &quot;HowToStep&quot;,
      &quot;text&quot;: &quot;Add in 1/3 a can of street corn, onion, cilantro to meat and mix thoroughly.&quot;
    },
    {
      &quot;@type&quot;: &quot;HowToStep&quot;,
      &quot;text&quot;: &quot;Scoop into tortillas; add cheese to inside; roll into greased oven pan.&quot;
    },
    {
      &quot;@type&quot;: &quot;HowToStep&quot;,
      &quot;text&quot;: &quot;Top with sauce and additional cheese.&quot;
    },
    {
      &quot;@type&quot;: &quot;HowToStep&quot;,
      &quot;text&quot;: &quot;Bake 25 minutes or until cheese is toasted.&quot;
    },
    {
      &quot;@type&quot;: &quot;HowToStep&quot;,
      &quot;text&quot;: &quot;Top with cilantro, French-fried onions, and bacon bits.&quot;
    }
  ]
}
&lt;/script&gt;
</content:encoded><category>Personal</category><category>Recipes</category><category>Home Server</category><category>cooking</category><category>recipe</category><category>enchiladas</category><category>personal-site</category><category>home-server</category><category>self-hosting</category></item><item><title>Making My Personal Site My Own</title><link>https://grantmclravy.com/blog/2025/03/16/making-my-personal-site-my-own/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2025/03/16/making-my-personal-site-my-own/</guid><description>I&apos;ve been a blogger for most of my life - but now I really want to start making my personal site my own.</description><pubDate>Sun, 16 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;I’ve been a blogger for most of my life - but now I really want to start making my personal site my own.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;h2 id=&quot;history-of-my-blogs&quot;&gt;History of my blogs&lt;/h2&gt;
&lt;h3 id=&quot;wordpress&quot;&gt;WordPress&lt;/h3&gt;
&lt;p&gt;I’ve been a WordPress user practically since I could think coherently. I believe that I started my first personal blog in early 2009 at 8 years old.&lt;/p&gt;
&lt;p&gt;&lt;em&gt;What thoughts worth reading would an eight year old have?&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;I first started writing tutorials for the game I was obsessed with at the time, Poptropica, a kid-friendly flash game with a virtual world. I eventually got added to a community blog of other kids who just enjoyed virtually hanging out. We wrote collaborative fan fiction and argued like a bunch of children wasting time. I look back at this time fondly, but the stuff I wrote makes modern me cringe.&lt;/p&gt;
&lt;p&gt;In my tweenage and teenage years, I redid my personal site as a spiritual prayer journal. The religious community I was a part of at the time was big into “being all-in” - &lt;em&gt;all of your life is all about God&lt;/em&gt; - so I thought my internet presence should be too. As I’ve deconstructed, I can look back at the very earnest blog posts, like the one where I declared I would give up video games because they didn’t further my relationship with God, and see that I was a misguided but passionate kid.&lt;/p&gt;
&lt;p&gt;In college, after I discovered my self-hosting passion, I spun up a WordPress docker container and wrote a few blog posts about my process setting up my home server.&lt;/p&gt;
&lt;p&gt;After college, when I started my career in IT and started to learn software development, the idea of having a website that really was my own began to be more appealing. On the other hand, after spending my workdays tinkering with computers, doing more of the same at home lost its appeal.&lt;/p&gt;
&lt;p&gt;I switched from WordPress to &lt;a href=&quot;https://squidfunk.github.io/mkdocs-material/&quot;&gt;Mkdocs Material&lt;/a&gt; for ease of maintenance and to match the documentation I was doing at work. This also meant I could write my personal blog posts in my favorite text editor, Obsidian. If you’re reading this blogpost recently after it came out, you’re likely reading it from the Mkdocs version of the blog. However, this was still hosted in my living room. As I continue to grow in my web development journey, I want to utilize modern cloud technology to deploy my sites — enter Cloudflare Pages.&lt;/p&gt;
&lt;h3 id=&quot;cloudflare-pages&quot;&gt;Cloudflare Pages&lt;/h3&gt;
&lt;p&gt;I’ve been looking into &lt;a href=&quot;https://pages.cloudflare.com&quot;&gt;Cloudflare Pages&lt;/a&gt; for a while now, and it seems like an interesting product. This would require I look outside my comfortable self-hosted bubble but would also stretch my skills in a good way. I don’t want to limit myself by refusing to utilize cloud-based technology because of my passion for self-hosting.&lt;/p&gt;
&lt;p&gt;Cloudflare Pages is a (&lt;a href=&quot;https://webmasters.stackexchange.com/questions/88659/how-can-cloudflare-offer-a-free-cdn-with-unlimited-bandwidth/88685#88685&quot;&gt;FREE&lt;/a&gt;!) web hosting platform with unlimited bandwidth for static sites. They even have a &lt;a href=&quot;https://developers.cloudflare.com/pages/framework-guides/deploy-an-mkdocs-site/&quot;&gt;template for Mkdocs&lt;/a&gt; that makes it relatively easy to switch to. All I need to do is connect Cloudflare to the Git repo I have for my site, and they handle the rest.&lt;/p&gt;
&lt;p&gt;GitHub will automatically trigger a build for my blog for the non-prod branches, protecting it behind &lt;a href=&quot;https://www.cloudflare.com/zero-trust/products/access/&quot;&gt;Cloudflare access&lt;/a&gt;. For the production branch of my blog’s Git Repo, it will push it to the world.&lt;/p&gt;
&lt;p&gt;Since I already configured my DNS for domains to be through Cloudflare, all I needed to do was adjust the CNAME record from my self-hosted server to the new site, and I was off to the races. If you’re reading this post, it’s coming from Cloudflare pages instead of the server in my living room.&lt;/p&gt;
&lt;p&gt;&lt;em&gt;For the record, I have no affiliation with Cloudflare; they just provide free DNS and hosting with very user friendly documentation.&lt;/em&gt;&lt;/p&gt;
&lt;h2 id=&quot;whats-next&quot;&gt;What’s Next&lt;/h2&gt;
&lt;p&gt;Soon(TM) I plan on coding my own Next.JS based static site that talks to a Wagtail based headless CMS on build. This is going to be my most complex personal project yet - I will be writing the front-end JavaScript, the backend Python code, and trying to make it look decent as well. I want to challenge myself to make something that is maintainable, expandable, and looks sleek. I’m genuinely excited for this project, but I know it’s going to stretch my development skills.&lt;/p&gt;
&lt;p&gt;I will likely deploy it using Cloudflare pages. I plan on documenting this process on this site - feel free to reach out if you want to chat about it.&lt;/p&gt;
</content:encoded><category>Development</category><category>self-hosting</category><category>website</category><category>blog</category><category>personal-site</category></item><item><title>Documentation 2: Electric Boogaloo</title><link>https://grantmclravy.com/blog/2024/05/22/documentation-2-electric-boogaloo/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2024/05/22/documentation-2-electric-boogaloo/</guid><description>18 months ago, I wrote a blog post about my process of documenting my home server&apos;s containerized applications. The very next day, OpenAI announced ChatGPT. I immediately started playing with the new shiny technology that could generate…</description><pubDate>Wed, 22 May 2024 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;18 months ago, I wrote a &lt;a href=&quot;https://grantmclravy.com/blog/2022/11/29/writing-and-maintaining-accurate-documentation/&quot;&gt;blog post&lt;/a&gt; about my process of documenting my home server’s containerized applications.&lt;/p&gt;
&lt;p&gt;The very next day, OpenAI &lt;a href=&quot;https://openai.com/index/chatgpt/&quot;&gt;announced&lt;/a&gt; ChatGPT. I immediately started playing with the new shiny technology that could generate text. My &lt;em&gt;well-intentioned&lt;/em&gt; plan to manually document each application according to a formatted template seemed less exciting. Therefore, my plan to have perfect documentation slowed. I focused more on doing more fun things with my server - adding family photo viewing capabilities to my Plex, improving my local DNS situation, and moving some more items from my HDD array to a new SSD.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/VaderDocumentationMeme.png.webp&quot; width=&quot;625&quot; height=&quot;399&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/VaderDocumentationMeme.png&quot;&gt;&lt;/p&gt;
&lt;!-- more --&gt;
&lt;p&gt;But my desire for documentation still loomed over me. There had to be an easier solution for this. For a bit, I kept trucking, occasionally writing some docs when I mustered up the motivation. I also began to note some pain points with my plans for my server’s docs.&lt;/p&gt;
&lt;h2 id=&quot;pain-points&quot;&gt;Pain Points&lt;/h2&gt;
&lt;h3 id=&quot;bookstack-is-great-for-other-people&quot;&gt;Bookstack is great, for other people&lt;/h3&gt;
&lt;p&gt;Bookstack is a phenomenal piece of software, and I really enjoyed using it at first. It has plenty of handy features, but it’s very overbuilt for what I need. The workflow also had plenty of physical clicks compared to the Obsidian workflow I had started using for my personal notes. The version control and user authentication features really didn’t provide any value to me when I’m the only one updating the app.&lt;/p&gt;
&lt;h3 id=&quot;mkdocs-is-really-good&quot;&gt;Mkdocs is really good&lt;/h3&gt;
&lt;p&gt;Markdown is an awesome format, and using the Obsidian editor to write documentation (and blog posts) is a great experience. I already used markdown-based documentation for my internal automations at work using Mkdocs, and the workflow of running one command to turn the folder of markdown files into a beautiful documentation website is incredibly smooth.&lt;/p&gt;
&lt;p&gt;The &lt;a href=&quot;https://squidfunk.github.io/mkdocs-material/&quot;&gt;Mkdocs Material&lt;/a&gt; theme also adds a bunch of handy features and looks incredible.&lt;/p&gt;
&lt;h3 id=&quot;writing-docs-takes-time&quot;&gt;Writing docs takes time&lt;/h3&gt;
&lt;p&gt;When I have free time to work on my homelab, do you think I would prefer to implement something new, fix something that is broken, or write documentation for something that may be working just fine? Even with the template, I still had to look things up and reference the official docs for the containers.&lt;/p&gt;
&lt;h2 id=&quot;chatgpt-api-comes-out&quot;&gt;ChatGPT API Comes Out&lt;/h2&gt;
&lt;p&gt;I had been playing with ChatGPT since it came out. I had learned the limitations - the core one being that LLMs have no sense of truth. As a language processor, however, they are great at following templates and outputting something that synthesizes source information into the proper format.&lt;/p&gt;
&lt;p&gt;The idea to have my documentation automatically generated by an LLM based upon the files for my server was attractive to me. Not only would I have the chance to build something based on the new shiny thing in tech, but I could solve a practical problem. Hence …&lt;/p&gt;
&lt;h2 id=&quot;the-new-documentation-plan&quot;&gt;The New Documentation Plan&lt;/h2&gt;
&lt;h3 id=&quot;parse-my-core-docker-compose-file-into-snippets&quot;&gt;Parse my core Docker Compose file into snippets&lt;/h3&gt;
&lt;p&gt;I have all of my containers in one massive docker compose file right now. I keep telling myself I will change that, and I for sure will … later. However, this made the process of splitting the containers for my entire setup into snippets very simple. I wrote some python code to make this happen.&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; yaml&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; split_compose&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(compose_file: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;str&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;) -&amp;gt; &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;list&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    “””&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#FDAEB7;font-style:italic&quot;&gt;    `split_compose`&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; accepts a docker&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;compose filepath.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    The compose &lt;/span&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt; is&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; split into individual yaml snippets per container.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    Output &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;is&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; an array of &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;YAML&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; snippet strings.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    “””&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;    with&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; open&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(compose_file, ‘r’) &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;as&lt;/span&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt; file&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        compose_data &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; yaml.safe_load(&lt;/span&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    # Extract services from the loaded compose data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    services &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; compose_data.get(‘services’, {})&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    yaml_snippets &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; []&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; service_name, service_data &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; services.items():&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        # Construct the yaml for individual service&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        snippet &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; yaml.safe_dump({‘services’: {service_name: service_data}, ‘version’: compose_data[‘version’]})&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        yaml_snippets.append(snippet)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; yaml_snippets&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;send-the-snippet-and-the-template-to-the-llm-api&quot;&gt;Send the snippet and the template to the LLM API&lt;/h3&gt;
&lt;p&gt;I used the same template that I had previously written the few docs I’d written before my automation project. Using this as a baseline, I created a prompt that had ChatGPT acting as a technical writer.&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; openai&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; json&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; generate_gpt_documentation&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(content):&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    response &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; openai.ChatCompletion.create(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;    model&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;“gpt&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;3.5&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;turbo”,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;    messages&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;[&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    {“role”:”system”,”content”:”You are a technical documentation writer. \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    The user provides a docker&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;compose &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;YAML&lt;/span&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt; file&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt; and&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; you write documentation about the container using the provided template.”},&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    {“role”:”system”,”content”:”””Here &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;is&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; the Markdown formatted template that the documentation should follow:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# [[App Name]]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;[[App Basic Description]]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;## URL:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;[https:&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;//&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;URL&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;.example.com](https:&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;//&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;URL&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;.example.com)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;## Mount Points:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;[[[Mount Points here]]]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;## Ports:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;[[Ports Here]]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;## Complete Docker Compose:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;yaml&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    sample&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;app:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        container_name : sample app&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        ports:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;         -&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; 1201&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;1201&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;## App Documentation:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;[https:&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;//&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;appdocs.github.io](https:&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;//&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;appdocs.github.io)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;## Credentials:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;[[Relevant Credentials]]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;## Additional Notes:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    [[Any additional context]]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    “””},&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    {“role”: “user”, “content”: f”{content}”}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        ]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;    print&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(json.dumps(response,&lt;/span&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;indent&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    documentation &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; response.get(‘choices’)[&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;].get(‘message’).get(‘content’)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;    print&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(documentation)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; documentation&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;output-the-synthesized-documentation-to-a-markdown-file&quot;&gt;Output the synthesized documentation to a markdown file&lt;/h3&gt;
&lt;p&gt;I wrote a function that took the content generated earlier and saved it to a markdown file.&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; write_markdown_file&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(container_name:&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;str&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;,content:&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;str&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;) -&amp;gt; &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;None&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;    with&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; open&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(f”docs&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;{container_name}.md”,’w’) &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;as&lt;/span&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt; file&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;        file&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;.write(content)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;create-functions-to-orchestrate-this&quot;&gt;Create functions to orchestrate this&lt;/h3&gt;
&lt;p&gt;I also wrote a function that accepted the individual YAML snippets and ran the GPT generation function on just that snippet, outputting it to a markdown file.&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; yaml&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; process_snippets_and_generate_docs&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(snippets: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;list&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;) -&amp;gt; &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;None&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    “””&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    Accepts a &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;list&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; of &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;YAML&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; snippets.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    Grabs the name of each container &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;from&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; the snippets.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    Runs the &lt;/span&gt;&lt;span style=&quot;color:#FDAEB7;font-style:italic&quot;&gt;`generate_gpt_documentation`&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; function on each snippet.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    “””&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; snippet &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; snippets:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        parsed_data &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; yaml.safe_load(snippet)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        service_name &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; list&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(parsed_data[‘services’].keys())[&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;]  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# Assuming one service per snippet&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        # Call the documentation generation function&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        doc &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; generate_gpt_documentation(snippet)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        write_markdown_file(&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;            container_name&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;service_name,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;            content&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; doc&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;        )&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;        print&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(f”Generated documentation &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; {service_name}.”)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;All I needed to get the whole process going was a way to call that function from a split compose file.&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#F97583&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; make_docs&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;():&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    compose_file_location &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; input&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;(“Enter the &lt;/span&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; path of your docker compose yaml &lt;/span&gt;&lt;span style=&quot;color:#FFAB70&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;”)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    snippets &lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; split_compose(compose_file_location)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    process_snippets_and_generate_docs(snippets)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;From there, I ran the &lt;code&gt;make_docs&lt;/code&gt; function and waited a few minutes for ChatGPT to work its magic.&lt;/p&gt;
&lt;h3 id=&quot;review-and-add-necessary-information-and-human-insights&quot;&gt;Review and add necessary information and human insights&lt;/h3&gt;
&lt;p&gt;The nice part of having ChatGPT generate documentation is that the LLM did all the formatting and syntax on my behalf. I had a great start to the documentation. However, just putting that site up without giving it the &lt;em&gt;human element&lt;/em&gt; doesn’t provide a whole lot of value. An AI doesn’t understand the &lt;em&gt;why&lt;/em&gt; behind the infrastructure. The way I did the documentation automation also didn’t give the full compose file as context - only the one container - so it didn’t get the bigger picture of &lt;em&gt;how&lt;/em&gt; the container fit into the home lab.&lt;/p&gt;
&lt;p&gt;I certainly needed to review every doc for factual accuracy. LLMs boldly lie to your face. The link to the documentation site was right about 60% of the time; the other 40% it made up something that felt close but didn’t go anywhere.&lt;/p&gt;
&lt;p&gt;For containers that are more niche, it took more liberties and guessed what they did. Those took the most time to tweak the output.&lt;/p&gt;
&lt;h3 id=&quot;use-mkdocs-to-turn-folder-of-markdown-files-into-beautiful-static-site&quot;&gt;Use Mkdocs to turn folder of markdown files into beautiful static site&lt;/h3&gt;
&lt;p&gt;I created a mkdocs project in the same folder as my &lt;code&gt;documentation_automation.py&lt;/code&gt;. Mkdocs is very simple to create the site - just one &lt;code&gt;mkdocs build&lt;/code&gt; command and the site is ready to go.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/IMG_0263.jpeg.webp&quot; width=&quot;1200&quot; height=&quot;1438&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/IMG_0263.jpeg&quot;&gt;&lt;/p&gt;
&lt;p&gt;This documentation above was almost entirely generated by AI. I had to add the context that 6123 is the port for the server map powered by &lt;a href=&quot;https://github.com/webbukkit/dynmap&quot;&gt;dynmap&lt;/a&gt;, but GPT 3.5 knew that 25565 was the standard Minecraft server port. It linked the correct &lt;a href=&quot;https://docker-minecraft-server.readthedocs.io/en/latest/&quot;&gt;documentation&lt;/a&gt; to the dockerized Minecraft server container I use. &lt;em&gt;Fun note - the official docs for this container also use Material for Mkdocs and look great!&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;The Minecraft server documentation was one of the best examples of AI generated docs. One of the worst items was a dashboard container I tried out called &lt;a href=&quot;https://github.com/pawelmalak/flame&quot;&gt;Flame&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/IMG_0264.jpeg.webp&quot; width=&quot;1200&quot; height=&quot;1476&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/IMG_0264.jpeg&quot;&gt;&lt;/p&gt;
&lt;p&gt;GPT-3.5 didn’t identify the correct container and made the assumption that Flame created &lt;a href=&quot;https://brendangregg.com/flamegraphs.html&quot;&gt;CPU flame graphs&lt;/a&gt; and needed Docker socket access to get performance information. Neither is accurate - Flame is a homepage generator for your home lab, and it can be set up to dynamically add links to your dashboard based on container labels.&lt;/p&gt;
&lt;h3 id=&quot;use-cloudflare-access-to-make-this-documentation-private&quot;&gt;Use Cloudflare Access to make this documentation private&lt;/h3&gt;
&lt;p&gt;One of the things Bookstack handled was authentication. I didn’t want my docs to be entirely public so I needed to figure out an alternative. I first tried a home-hosted authentication and identity provider application called &lt;a href=&quot;https://goauthentik.io/&quot;&gt;Authentik&lt;/a&gt;. It worked but it was difficult to configure and manage, so I continued to look for an alternative. I also looked into switching my reverse proxy from &lt;a href=&quot;https://nginxproxymanager.com/&quot;&gt;Nginx Proxy Manager&lt;/a&gt; to &lt;a href=&quot;https://traefik.io/traefik/&quot;&gt;traefik&lt;/a&gt; but that’s the scope creep monster rearing its ugly head once again. Certainly a project I’m looking forward into doing in the future. However, for the time being,
I wanted a solution that I could quickly deploy for my documentation project but still keep security at the forefront.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.cloudflare.com/zero-trust/products/access/&quot;&gt;Cloudflare Access&lt;/a&gt; seemed like a great option. I already used Cloudflare for my DNS provider, so adding their access control was a great fit for me. Setting it up was also very simple.&lt;/p&gt;
&lt;p&gt;For work, I have the pleasure of dealing with the Microsoft Office 365 environment. I set up a personal 365 tenant to have a playground to test things for my homelab. I set up Azure AD / Entra ID as my identity provider in Cloudflare Access. Then I set up a rule with Cloudflare to allow only those in a specific AD group into my documentation.&lt;/p&gt;
&lt;p&gt;Finally, it all came together. I had complete documentation for all my web apps, available behind authentication on the &lt;a href=&quot;https://docs.granto.cloud&quot;&gt;public internet&lt;/a&gt;.  My project to document was complete - you never need to update docs, right? ;)&lt;/p&gt;
&lt;p&gt;As always, if you have any questions, &lt;a href=&quot;https://grantmclravy.com/contact/&quot;&gt;reach out&lt;/a&gt;! I’m always glad to chat about these kinds of things.&lt;/p&gt;
</content:encoded><category>Home Server</category><category>AI</category><category>documentation</category><category>home-server</category><category>project-management</category><category>ai</category></item><item><title>Writing and Maintaining Accurate Documentation</title><link>https://grantmclravy.com/blog/2022/11/29/writing-and-maintaining-accurate-documentation/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2022/11/29/writing-and-maintaining-accurate-documentation/</guid><description>Documentation for any type of technology project is crucial, especially if there are multiple people working on a project. Even if there&apos;s only one person, the human mind doesn&apos;t have perfect recall. My home server started as a simple…</description><pubDate>Tue, 29 Nov 2022 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Documentation for any type of technology project is crucial, especially if there are multiple people working on a project. Even if there’s only one person, the human mind doesn’t have perfect recall.&lt;/p&gt;
&lt;p&gt;My home server started as a simple experimental playground for learning Unix-like operating systems, managing applications, and best-practices for file management. Over the past two years, the project ballooned into a media management server, web server, download client, chat host, cloud server, Git and development server with CI/CD integration all in one.&lt;/p&gt;
&lt;p&gt;Each project by itself was manageable by itself, but as someone who is constantly learning and implementing new things, each project tended to build on the previous one. Then, when something broke due to an update or network blip (or more likely, an initial mis-configuration), I would have to go back and attempt to remember what I had done last time. This was annoying but not too big of a deal - it was just my personal project, and the time it would take to document each application wouldn’t be worth the time it takes to troubleshoot my apps.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;p&gt;Then, I started working IT helpdesk at a medium-sized enterprise. The documentation where I work is a bit of a mess. There is a ton of documentation, though much of it is not up-to-date nor relevant to the applications our users actually use. Our documentation is scattered between several places - you never know if the documentation for that app is in our ticket system knowledgebase, an internal SharePoint site, or a Word document sitting on a network share somewhere. There have been several projects to clean up the internal documentation, but those projects always are lower priority than helping customers or building new software.&lt;/p&gt;
&lt;p&gt;For my personal projects, and developing good habits when I’m working with code projects, I’m committing to producing high-quality, up-to-date documentation. For my home server, this means that I have a significant project ahead of me - I currently have 76 containers, most of them web apps with separate functions that need documentation. To get this documented, and documented well, I need to have a plan, and a way to keep track of my project.&lt;/p&gt;
&lt;p&gt;I use &lt;a href=&quot;https://vikunja.io/&quot;&gt;Vikunja&lt;/a&gt; as my project management software of choice right now. It’s an open source to-do list application that I can host on my server. I will keep track of which software I’ve documented there, including links to the documentation itself. I’ll use a kanban system to organize which are in progress, which are up next.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/8543096b-83e2-4971-b73c-8277c427ab5f.png.webp&quot; width=&quot;1200&quot; height=&quot;708&quot; alt=&quot;image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/8543096b-83e2-4971-b73c-8277c427ab5f.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I typically use &lt;a href=&quot;https://obsidian.md/&quot;&gt;Obsidian.md&lt;/a&gt; for writing and documenting things, but this documentation needed to be a little more permanent than a collection of plain text files. At work, for my code projects, I use &lt;a href=&quot;https://www.mkdocs.org/&quot;&gt;mkdocs&lt;/a&gt; to turn my Obsidian folder into web documentation, then serve it as part of the Django project that holds my project.&lt;/p&gt;
&lt;p&gt;I would prefer to have a web-based option with integrated version control. A few months ago, while browsing the &lt;a href=&quot;https://linuxserver.io&quot;&gt;linuxserver.io&lt;/a&gt; container &lt;a href=&quot;https://fleet.linuxserver.io&quot;&gt;manifest&lt;/a&gt;, I found Bookstack. This lovely piece of software is PHP-based and is built just for this type of private wiki.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/19d14fbe-b865-485e-8147-3ae14ad1e633.png.webp&quot; width=&quot;1200&quot; height=&quot;816&quot; alt=&quot;image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/19d14fbe-b865-485e-8147-3ae14ad1e633.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;It’s also quite attractive as well. It accepts markdown input, so I could continue to write in Obsidian.md if I preferred. It also has a fancy template system, so I can write a solid template, and use that to keep my documentation consistent across my different applications.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/edf16239-9917-4f91-aaa9-0339bc6d3942.jpg.webp&quot; width=&quot;1200&quot; height=&quot;873&quot; alt=&quot;image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/edf16239-9917-4f91-aaa9-0339bc6d3942.jpg&quot;&gt;&lt;/p&gt;
&lt;p&gt;I started a project to implement Bookstack right when I discovered it. Like most of my home server projects, there was an initial burst of energy towards getting things documented. Then, it became apparent that documenting each app would be hard work. How do I ensure that this documentation push is not another project that dies down? Or even if I succeed in adding every current application I have, how do I ensure that as I change configurations or add apps, that my documentation stays up-to-date and usable?&lt;/p&gt;
&lt;p&gt;I plan on:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Making documentation a central part of my project - it’s a cultural shift from keeping knowledge in my head to writing it down.&lt;/li&gt;
&lt;li&gt;Documenting new apps as part of the deployment process - before I move on to something new, I will ensure that my new app is documented well.&lt;/li&gt;
&lt;li&gt;Documenting 2-3 existing apps per week until my entire documentation backlog is complete.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;I’ve also been enjoying writing new posts for my blog lately. I’ve had a post explaining all my home-server apps on the backlog for a long while now. As part of this documentation process, I’ll be working on writing this mega-post. It might be a little quieter on this blog for a bit (not that it’s usually active) but one of my next posts might be quite long and detailed.&lt;/p&gt;
</content:encoded><category>Home Server</category><category>documentation</category><category>home-server</category><category>project-management</category></item><item><title>Leaving Corporate Social Media ...</title><link>https://grantmclravy.com/blog/2022/11/24/leaving-corporate-social-media-/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2022/11/24/leaving-corporate-social-media-/</guid><description>Social media has radically changed the world - I don&apos;t think there&apos;s a person on this planet that would disagree with that. Social media is also in a bit of an upheaval phase right now. Twitter has been bought out by an insane billionaire…</description><pubDate>Thu, 24 Nov 2022 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Social media has radically changed the world - I don’t think there’s a person on this planet that would disagree with that.&lt;/p&gt;
&lt;p&gt;Social media is also in a bit of an upheaval phase right now. Twitter has been bought out by an insane billionaire intent on changing the company to a profitable “free-speech” haven, while Facebook is dumping billions of dollars into moonshot “metaverse” projects to maintain their relevance as their core product becomes less relevant.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;Social media giants typically have incentives that don’t exactly line up with what the user wants to see in social media.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;!-- more --&gt;
&lt;p&gt;For example, social media companies make their primary source of revenue through advertising - they want to show you as many ads as you’re willing to tolerate while keeping you on the site as long as possible. They accomplish this by showing you algorithmic recommendations of posts they think you might enjoy rather than just content from people you follow or are friends with.&lt;/p&gt;
&lt;p&gt;Many users would prefer fewer ads and a return to true chronological feeds, but this would not be in social media company’s best interest, so they don’t provide these options or bury them behind confusing settings menus.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/1efe7cbf-2e5e-41ec-8886-219a0f2e1f43.jpg.webp&quot; width=&quot;1200&quot; height=&quot;900&quot; alt=&quot;image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/1efe7cbf-2e5e-41ec-8886-219a0f2e1f43.jpg&quot;&gt;&lt;br&gt;
Back when I first signed up for a Facebook account, the chronological feed of just posts from my friends enabled me to clearly see when there was no more content - I knew when to log off the Facebook page after catching up with all the things my friends cared to share. Years later, my Facebook feed was filled with posts from groups or pages I had not decided to follow, yet Facebook served to me anyway because the almighty algorithm determined those posts would get me to stay on the site longer.&lt;/p&gt;
&lt;p&gt;In 2021, I deleted my Facebook account after a few months of contemplation. There was not a whole lot of difference between a Facebooked life and a de-Facebooked life - the biggest difference wasn’t the lack of the news feed, it was Facebook Messenger that I missed the most. My family group chat was Facebook Messenger, so I had to convince them to switch to a Matrix group chat through Element.&lt;/p&gt;
&lt;p&gt;A few months later, I deleted my Twitter account as well. I was more of a lurker with Twitter - using it to keep up with news and culture. However, Twitter is also excellent at being a time suck, and tends to breed negativity.&lt;/p&gt;
&lt;p&gt;Social media still has value, but I didn’t want to be beholden to a corporate overlord to decide what I was going to see.&lt;/p&gt;
&lt;p&gt;Enter Mastodon.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/88f72bf7-ec55-41ab-911d-c88d8bc372aa.png.webp&quot; width=&quot;313&quot; height=&quot;81&quot; alt=&quot;image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;/p&gt;
&lt;p&gt;Mastodon is an open-source federated social media platform. That’s a bunch of buzzwords. Let me break that down for you.&lt;/p&gt;
&lt;p&gt;Mastodon is open-source, which means the code for the project is readily available for anyone to read or edit. To be precise, Mastodon is released under the &lt;a href=&quot;https://www.gnu.org/licenses/agpl-3.0.txt&quot;&gt;AGPLv3&lt;/a&gt; license, meaning that the code MUST be available - any distribution of the software without code available would be breaking the license agreement. Due to the open source nature of the software, if there was a feature I thought was missing from Mastodon, I would be able to add it to the software, then submit it to the project maintainers to add to the original project.&lt;/p&gt;
&lt;p&gt;Mastodon is federated, meaning that it follows a consistent format to allow communication from different servers. For example, my mastodon instance at &lt;a href=&quot;https://gran.to/social&quot;&gt;mastodon.granto.cloud&lt;/a&gt; allows me to follow &lt;a href=&quot;https://universeodon.com/@georgetakei&quot;&gt;George Takei&lt;/a&gt; despite the fact that he joined the &lt;a href=&quot;https://universeodon.com/explore&quot;&gt;universeodon.com&lt;/a&gt; mastodon server, not the granto.cloud mastodon server. It’s also compatible with other social media sites using the ActivityPub - the biggest name is soon to be Tumblr - for more info see &lt;a href=&quot;https://techcrunch.com/2022/11/21/tumblr-to-add-support-for-activitypub-the-social-protocol-powering-mastodon-and-other-apps/&quot;&gt;here&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Right now I’m posting out to the void, just like I am with this blog. Zero mastodon followers so far, but it’s a really cool concept to completely own the social media presence. I know exactly where my data is being hosted - currently about 15 feet from me as I type this blog post out.&lt;/p&gt;
&lt;p&gt;Feel free to follow me on Mastodon - I am [@&lt;a href=&quot;mailto:Granto@mastodon.granto.cloud&quot;&gt;Granto@mastodon.granto.cloud&lt;/a&gt;] - or you can go to &lt;a href=&quot;https://gran.to/social&quot;&gt;https://gran.to/social&lt;/a&gt;.&lt;/p&gt;
</content:encoded><category>Social Media</category><category>mastodon</category><category>self-hosting</category><category>social-media</category></item><item><title>Building the Ultimate Home Server – Part Six - Uptime Monitoring</title><link>https://grantmclravy.com/blog/2022/06/09/building-the-ultimate-home-server--part-six---uptime-monitoring/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2022/06/09/building-the-ultimate-home-server--part-six---uptime-monitoring/</guid><description>It’s been a while since I have written a blog post about my home server. I’ve been working away on my personal project for a while now, adding more features and more integrations - cool ways to make data do cool things. I recently had a…</description><pubDate>Thu, 09 Jun 2022 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;It’s been a while since I have written a blog post about my home server. I’ve been working away on my personal project for a while now, adding more features and more integrations - cool ways to make data do cool things.&lt;/p&gt;
&lt;p&gt;I recently had a power outage at my apartment. I keep my server on an uninterruptible power supply to ensure that I don’t lose any data. I also keep my modem and router on the UPS but typically when the apartment loses power, the internet goes down as well. This means my server isn’t accessible - and the external services I’ve configured to depend on it may have a service interruption.&lt;/p&gt;
&lt;p&gt;I could use a cloud service like Uptime Robot to check if my services are currently functional and up - it would automatically check if my service is accessible from the view of a third party. These cloud-hosted products cost money and are against my ethos of self-hosting everything I can.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;p&gt;I use an uptime monitoring service called Uptime Kuma to keep track of which services are currently up. Uptime Kuma is a home-hosted alternative to these cloud services that checks if my web sites are accessible. Every minute, it sends an HTTP GET request to my web services and confirms that there aren’t any access errors. If there are any errors, I have it configured with Mailgun to send me an email. It checks accessibility from the internet, and even sends me a notification when my SSL certificates are about to expire.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-1024x681.jpg.webp&quot; width=&quot;1200&quot; height=&quot;798&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-1024x681.jpg&quot;&gt;&lt;/p&gt;
&lt;p&gt;It’s pretty and it’s dark mode? What’s not to love?&lt;/p&gt;
&lt;p&gt;Because this is hosted in a docker container, I can isolate it from the rest of my containers. While most of my containers use local DNS through Pi-hole, my Uptime Kuma container uses Cloudflare’s 1.1.1.1 DNS to see what the public internet sees for these sites, including the Cloudflare proxy at the DNS level. If public DNS is misconfigured but local DNS is fine, Uptime Kuma will let me know.&lt;/p&gt;
&lt;p&gt;However, this doesn’t solve my power outage problem. If my local internet is down, Uptime Kuma can’t send me emails notifying me that my server is down. It also can’t make public requests if the server itself is the problem rather than the internet. Hosting my uptime checker on the server I’m checking uptime on is a bit of a circular logic problem.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“So I should have just paid for Uptime Robot?”&lt;/p&gt;
&lt;p&gt;— Skeptical Home Hosting Enthusiast&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Of course not! That’s not the way we do things here at the GrantMcLravy.com blog(TM). I found the Google Cloud free tier. Unlike the AWS EC2 free tier, the Google Compute Engine free tier is always free instead of free for just the first twelve months (until Google decides to change that.)&lt;/p&gt;
&lt;p&gt;Google Cloud also includes a free external IPV4 IP, quite a valuable bonus in 2022.&lt;/p&gt;
&lt;p&gt;Even though this isn’t exactly home-hosting, it’s still controlling the software stack yourself. The true home-hosting way would be to build a second server at an off-site location, but learning cloud deployment processes is also a valuable skill in today’s IT environment.&lt;/p&gt;
&lt;p&gt;I set up the Compute Engine instance as a Ubuntu server instance. I ssh-ed in using the web interface, and set up my standard web-hosting stack:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Docker and Docker Compose&lt;/li&gt;
&lt;li&gt;MariaDB&lt;/li&gt;
&lt;li&gt;Nginx Proxy Manager&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;I used my own guide to install all this - &lt;a href=&quot;https://grantmclravy.com/blog/2021/11/20/building-the-ultimate-home-server---part-four---creating-a-docker-framework/&quot;&gt;part four of this series.&lt;/a&gt; The Uptime Kuma install was as easy as adding the following lines to my Docker Compose file:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    uptime-kuma&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;louislam/uptime-kuma:1&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;uptime-kuma&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;3001:3001&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    dns&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;1.1.1.1&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;uptime-kuma:/app/data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  uptime-kuma&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;I added my IPV4 address for my Google Cloud instance to my Cloudflare DNS records for my domain, set up the reverse proxy settings in Nginx Proxy Manager, and… nothing.&lt;/p&gt;
&lt;p&gt;When hosting from home, I needed to open up port 443 in my router settings. Cloud hosting means I don’t control ports at the router level - I have to open the ports in the Compute Engine admin portal. After struggling through the documentation for a little bit, I got port 80 and 443 open, and I was able to access my uptime tracker successfully.&lt;/p&gt;
&lt;p&gt;Uptime Kuma allows you to export your database of URLs - this makes creating two duplicate instances very simple. I imported my settings from my existing database, set up notifications, and it was magically set up! To test that it works, I unplugged my home server’s ethernet cable, and waited the 3 minutes for the emails to come through. One set of email notifications for all my services came through. When I plugged my server back in, I got two sets of notifications that everything is back up.&lt;/p&gt;
&lt;p&gt;As of right now, when I set up a new app, I have to manually set up both status checkers to include it. Uptime Kuma has an internal API that I might be able to integrate into my app deployment process - there may be a blog post about my API integrations soon(TM).&lt;/p&gt;
&lt;p&gt;Uptime monitoring allows me to know immediately when something goes down, but that’s only half the picture. Another future(TM) thing that I’m working on implementing is automatically switching key services to my cloud-hosted EC2 when the local container goes down. There’s quite a bit of groundwork to get that set up, so that might be a farther future type of thing, but it’s in the pipeline.&lt;/p&gt;
&lt;p&gt;As always, feel free to reach out if you have any questions or advice for me as I continue through this home-hosting adventure! &lt;a href=&quot;https://grantmclravy.com/contact/&quot;&gt;Contact&lt;/a&gt; is the best way to reach me!&lt;/p&gt;
</content:encoded><category>Home Server</category></item><item><title>Building the Ultimate Home Server – Part Five - Fixing my Docker Compose Situation</title><link>https://grantmclravy.com/blog/2021/12/23/building-the-ultimate-home-server--part-five---fixing-my-docker-compose-situation/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2021/12/23/building-the-ultimate-home-server--part-five---fixing-my-docker-compose-situation/</guid><description>In my last post, I discussed how I was using Docker to deploy web apps on my home server. In the past month since then, I&apos;ve continued to tinker with my process, and I&apos;ve learned a little bit more about making it a little easier for myself.</description><pubDate>Thu, 23 Dec 2021 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;In my &lt;a href=&quot;https://grantmclravy.com/blog/2021/11/20/building-the-ultimate-home-server---part-four---creating-a-docker-framework/&quot;&gt;last post,&lt;/a&gt; I discussed how I was using Docker to deploy web apps on my home server. In the past month since then, I’ve continued to tinker with my process, and I’ve learned a little bit more about making it a little easier for myself.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;h2 id=&quot;portainer-stacks-are-dumb&quot;&gt;Portainer Stacks are Dumb&lt;/h2&gt;
&lt;p&gt;I really didn’t have a clear reason why I was using Portainer stacks to handle my docker-compose files. I liked having one single place to handle my entire server. However, using one docker-compose.yml as the authoritative source of app information does not necessitate pasting it into a web interface to gain the benefits of having Portainer stacks.&lt;/p&gt;
&lt;p&gt;One of the few advantages of having a Portainer Stack rather than a traditional .yml compose file is the ability to pull the whole stack down using a single click. If you have several stacks, it might make sense. For my server, I have one stack that controls all apps. If one app was being troublesome, I would go directly to that container and restart it from the Portainer GUI - I wouldn’t take my entire server down to fix one small issue. I can still view information at a glance with Portainer significantly easier than querying through the command line - Portainer itself still has value, but not as the source for my compose files.&lt;/p&gt;
&lt;p&gt;As the number of containers in my docker compose neared 50 separate services, Portainer would have more errors deploying my giant stack. There was no explanation for why the deployment failed. The message would simply say &lt;em&gt;Failure to deploy stack&lt;/em&gt; with no additional information. Oftentimes simply trying again seconds later would fix the issue, but I shouldn’t have to do the same thing over and over - that’s the definition of insanity.&lt;/p&gt;
&lt;h2 id=&quot;docker-compose-cli-gives-me-the-control&quot;&gt;Docker Compose CLI Gives Me the Control&lt;/h2&gt;
&lt;p&gt;After some troubleshooting, I found that having such a large stack meant that the health check that confirms that apps are up after 60 seconds would fail because docker was working on installing other apps. With Portainer, there was no way to change the length of the health check, so docker was assuming that it had failed when it just needed patience. With the docker-compose command, I was able to change the health check as an environment variable. So then, I would navigate to where my docker-compose.yml file was located and run this command:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;  COMPOSE_HTTP_TIMEOUT=1200 docker-compose up -d&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; &lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;If I was really smart, I would set up a bash alias so I could run something like &lt;code&gt;server-up&lt;/code&gt; and have this variable included by default. It’s on the list of things to happen in the future…&lt;/p&gt;
&lt;h2 id=&quot;git-makes-docker-compose-simple&quot;&gt;Git Makes Docker Compose Simple&lt;/h2&gt;
&lt;p&gt;Back when I was using Portainer, I started out with a stack that was linked to a git repo. In my quest to eliminate variables to try to get the &lt;em&gt;Failure to deploy stack&lt;/em&gt; message to stop showing up, I started manually copying and pasting. This made my life slightly more annoying. However, now that I wasn’t using stacks any more and was just using a .yml file, it was back to using a Git repo once again.&lt;/p&gt;
&lt;p&gt;I host my docker-compose file in my own home-hosted GitLab instance. GitLab gives me a web text editor that I can use to edit my compose file from anywhere. I could then ssh into my server, do a quick &lt;code&gt;git pull&lt;/code&gt;, then &lt;code&gt;docker-compose up -d&lt;/code&gt; and it’s off to the races.&lt;/p&gt;
&lt;h2 id=&quot;deploying-a-custom-link-shortener&quot;&gt;Deploying a Custom Link Shortener&lt;/h2&gt;
&lt;p&gt;Twitter has their own custom link shortener - t.co - that enables Twitter users to share links while simultaneously giving Twitter another opportunity to gobble users’ data. I’ve also personally used Bit.ly for personal link sharing. But I have a home server… why not host something similar to bit.ly myself?&lt;/p&gt;
&lt;p&gt;The open-source project &lt;a href=&quot;https://polrproject.org/&quot;&gt;Polr&lt;/a&gt; allows you to do just that - home-hosted link shortening made easier.&lt;/p&gt;
&lt;p&gt;I already own the domain name grantmclravy.com, using that for personal projects, including this blog, so I slapped together a quick Polr container using &lt;a href=&quot;https://hub.docker.com/r/ajanvier/polr&quot;&gt;this Docker container&lt;/a&gt;. I added it to my Docker compose file like so:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;   polr&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;ajanvier/polr&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;24632:8080&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_HOST&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;db&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_DATABASE&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_USERNAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr-db-pw&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      APP_NAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;Granto Link Shortener&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      APP_ADDRESS&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;links.grantmclravy.com&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      ADMIN_USERNAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;AdminUser&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      ADMIN_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr-admin-pw&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      ADMIN_EMAIL&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;Admin@Email.com&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      SETTING_SHORTEN_PERMISSION&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;true&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_HOST&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;smtp.mailgun.org&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_PORT&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;465&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_USERNAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr@m.grantmclravy.com&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr-email-pw&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_FROM_ADDRESS&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr@m.grantmclravy.com&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_FROM_NAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;Polr Link Shortener&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;I added a new host in Nginx Proxy Manager to redirect links.grantmclravy.com to port 24632 on my server, adding my previously created SSL certificate, and I had a custom link shortener. I tried it out with friends: sending them a link to &lt;a href=&quot;https://links.grantmclravy.com/not-a-rickroll&quot;&gt;https://links.grantmclravy.com/not-a-rickroll&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/Pasted-image-20211219230110.png.webp&quot; width=&quot;869&quot; height=&quot;63&quot; alt=&quot;Images&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/Pasted-image-20211219230110.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;If you’re a goober and have been on the internet for a baby bit, you’ll probably recognize that link is definitely a rickroll.&lt;/em&gt;&lt;/p&gt;
&lt;h3 id=&quot;but-linksgrantmclravycom-is-lame&quot;&gt;But… links.grantmclravy.com is lame&lt;/h3&gt;
&lt;p&gt;&lt;code&gt;bit.ly&lt;/code&gt; is nice and short. &lt;code&gt;t.co&lt;/code&gt; is even better. To have a good link shortener, it should be… well… short, right?&lt;/p&gt;
&lt;h3 id=&quot;enter-the-polynesian-island-of-tonga&quot;&gt;&lt;em&gt;Enter the Polynesian island of Tonga&lt;/em&gt;&lt;/h3&gt;
&lt;p&gt;&lt;a href=&quot;https://en.wikipedia.org/wiki/Tonga&quot;&gt;Tonga&lt;/a&gt; is a Polynesian island nation with a rich history. The island of Tonga was the capital of the Tongan empire, a powerful empire that reached its peak in about AD 1250. Scholars believe the Tongan empire was formed around AD 950 and lasted all the way until 1865. My western-centric brain assumed that the empire would have fallen when Britain annexed them into the British empire, but Tonga was never part of the British Empire. Tonga remained independent, having a “Treaty of Friendship” with the British government. The Tongan Monarch remained in control of the island nation until 2008, when Tonga became a constitutional monarchy with much of the power being placed in the prime minister. Pretty cool, right? This is the type of stuff I never heard in my World History class that is absolutely fascinating.&lt;/p&gt;
&lt;p&gt;Tonga also happens to have a really cool TLD (Top Level Domain) of &lt;code&gt;.to&lt;/code&gt;. I was able to buy &lt;code&gt;gran.to&lt;/code&gt; for $40. I changed my Docker compose to:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;   polr&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;ajanvier/polr&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;24632:8080&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_HOST&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;db&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_DATABASE&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_USERNAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr-db-pw&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      APP_NAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;Gran.to Link Shortener&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      APP_ADDRESS&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;gran.to&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      ADMIN_USERNAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;AdminUser&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      ADMIN_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr-admin-pw&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      ADMIN_EMAIL&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;Admin@Email.com&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      SETTING_SHORTEN_PERMISSION&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;true&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_HOST&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;smtp.mailgun.org&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_PORT&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;465&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_USERNAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr@m.grantmclravy.com&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr-email-pw&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_FROM_ADDRESS&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;polr@m.grantmclravy.com&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MAIL_FROM_NAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;Polr Link Shortener&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;and set up Cloudflare DNS, https certs, and Nginx Proxy Manager as explained in my last post.&lt;/p&gt;
&lt;p&gt;Try this on for size:&lt;br&gt;
&lt;a href=&quot;https://gran.to/rickroll&quot;&gt;https://gran.to/rickroll&lt;/a&gt;&lt;br&gt;
&lt;em&gt;What you see is what you get. It says rickroll; you get rickrolled. No tomfoolery here. Plus it’s just a bop.&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;I also set up a redirect for this site at &lt;a href=&quot;https://gran.to/blog&quot;&gt;https://gran.to/blog&lt;/a&gt; - pretty fancy, eh?&lt;/p&gt;
&lt;h2 id=&quot;in-conclusion&quot;&gt;In conclusion&lt;/h2&gt;
&lt;p&gt;Playing with a home server is an awesome hobby that has taught me so much. When I started this project, I was an accounting student playing with technology in-between classes. Now, I’m a full-time IT professional that gets paid to play with computers all day. God truly has been good to me these past few months.&lt;/p&gt;
</content:encoded><category>Home Server</category></item><item><title>Building the Ultimate Home Server - Part Four - Creating a Docker Framework</title><link>https://grantmclravy.com/blog/2021/11/20/building-the-ultimate-home-server---part-four---creating-a-docker-framework/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2021/11/20/building-the-ultimate-home-server---part-four---creating-a-docker-framework/</guid><description>In my last post, I discussed why I decided to move my server from TrueNAS to Ubuntu. Perhaps the largest software-based reason was the ability to use Docker to manage the software on my server. This post is a hybrid between a narrative…</description><pubDate>Sat, 20 Nov 2021 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;In my last &lt;a href=&quot;https://grantmclravy.com/blog/2021/11/04/building-the-ultimate-home-server---part-three---why-i-switched-from-truenas-to-ubuntu/&quot;&gt;post&lt;/a&gt;, I discussed why I decided to move my server from &lt;a href=&quot;https://www.truenas.com/&quot;&gt;TrueNAS&lt;/a&gt; to Ubuntu. Perhaps the largest software-based reason was the ability to use &lt;a href=&quot;https://www.docker.com/&quot;&gt;Docker&lt;/a&gt; to manage the software on my server. This post is a hybrid between a narrative telling how I got my server working and a guide to do it yourself. If you’d like any help with any of the stuff I list in this guide, feel free to &lt;a href=&quot;https://grantmclravy.com/contact/&quot;&gt;reach out&lt;/a&gt;! I’d be glad to help.&lt;/p&gt;
&lt;!-- more --&gt;
&lt;hr&gt;
&lt;h3 id=&quot;preparing-my-os&quot;&gt;Preparing my OS&lt;/h3&gt;
&lt;p&gt;The first time I set up my Docker instance, I did not put thought into organization and file management beforehand. This led to chaos with different applications needing access to different folders with different permissions. It made Docker volume management a mess. Because of this, I definitely recommend putting some thought into how you’re going to be storing files beforehand, including:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Media Files&lt;/li&gt;
&lt;li&gt;Configuration Files for Containers&lt;/li&gt;
&lt;li&gt;Databases&lt;/li&gt;
&lt;li&gt;Download locations&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;I have one central folder for my Docker folder configs. (/BigThiccums/ContainerConfigs) I also place my media files in a central folder. (/BigThiccums/Media) My Plex library is within (/BigThiccums/Media/Library) and contains my Movie, TV Show, and Music folders. I’ll discuss databases shortly.&lt;/p&gt;
&lt;p&gt;As previously described, I’m using &lt;a href=&quot;https://en.wikipedia.org/wiki/ZFS&quot;&gt;ZFS&lt;/a&gt; to store my files. Docker includes &lt;a href=&quot;https://docs.docker.com/storage/storagedriver/zfs-driver/&quot;&gt;native ZFS support&lt;/a&gt; but it’s not recommended for those “inexperienced with ZFS on Linux.” Perfect for people like me then, right? This is a home-server, so following best practices is not as crucial as the opportunity to learn the process of implementing cool technologies.&lt;/p&gt;
&lt;h3 id=&quot;installing-docker&quot;&gt;Installing Docker&lt;/h3&gt;
&lt;p&gt;One of the joys of using Linux is simply running some commands, and the software is magically installed. I sometimes find that far easier than Googling the program, finding the official website, downloading the .exe, running and configuring it pre-install. Docker is a little bit more complicated of an install than other softwares included in the default repo, but it’s not too bad.&lt;/p&gt;
&lt;p&gt;I used the official Docker install guide &lt;a href=&quot;https://docs.docker.com/engine/install/ubuntu/&quot;&gt;here&lt;/a&gt; to install Docker. I ran the following commands, as pulled from the guide:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; apt-get&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; update&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Updating the package manager&lt;/em&gt;&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; apt-get&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;    ca-certificates&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;    curl&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;    gnupg&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;    lsb-release&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Preparing the package manager to install the GPG key&lt;/em&gt;&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; curl&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -fsSL&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; https://download.docker.com/linux/ubuntu/gpg&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt; |&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; gpg&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; --dearmor&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -o&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; /usr/share/keyrings/docker-archive-keyring.gpg&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Adding the Docker repo’s GPG key&lt;/em&gt;&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; echo&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;  &quot;deb [arch=$(&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt;dpkg&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; --print-architecture&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;\&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;  $(&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt;lsb_release&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -cs&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;) stable&quot;&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt; |&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; tee&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; /etc/apt/sources.list.d/docker.list&lt;/span&gt;&lt;span style=&quot;color:#F97583&quot;&gt; &amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; /dev/null&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Installing the Docker repository&lt;/em&gt;&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; apt-get&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; update&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; apt-get&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; docker-ce&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; docker-ce-cli&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; containerd.io&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Actually installing Docker&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;If you’re comfortable with adding your user to the docker group, you can do so by running the following command:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; groupadd&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; docker&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; &amp;amp;&amp;amp; &lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt;sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; usermod&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -aG&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; docker&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt; $USER&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Creating the docker group and adding yourself to it&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;This may be a security risk, but it should be fine for a home server environment. This will mean you don’t have to sudo every single time you pull a new docker container - saving the number of times you will be typing in your password, but you should always be careful that the container you are pulling is from the official sources.&lt;/p&gt;
&lt;p&gt;Docker Compose is a tool where you can have central text files control the configuration for your Docker containers. I don’t know why it isn’t included by default in Docker, as it’s a really cool feature, but you can run the following commands, as pulled from the official Docker Compose install guide:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt;sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; curl&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -L&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; &quot;https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt;uname&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -s&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;)-$(&lt;/span&gt;&lt;span style=&quot;color:#B392F0&quot;&gt;uname&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -m&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;)&quot;&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -o&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; /usr/local/bin/docker-compose&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Installing docker compose from the GitHub&lt;/em&gt;&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; chmod&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; +x&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; /usr/local/bin/docker-compose&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Making Docker Compose executable&lt;/em&gt; &lt;/p&gt;
&lt;p&gt;I personally use Portainer as a GUI to manage my containers.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/Portainer-Dashboard-1024x529.png.webp&quot; width=&quot;1024&quot; height=&quot;529&quot; alt=&quot;Portainer&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/Portainer-Dashboard-1024x529.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Portainer is absolutely not necessary if you want to use Docker Compose, but it does have some convenient features - I can restart a container through the web interface.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/Wordpress-1024x324.png.webp&quot; width=&quot;1024&quot; height=&quot;324&quot; alt=&quot;Wordpress&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/Wordpress-1024x324.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;If I wanted to restart this blog, I’ll do that here.&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;Portainer was the only container I installed using the command-line. I pulled the command from the official &lt;a href=&quot;https://docs.portainer.io/v/ce-2.9/start/install/server/docker/linux&quot;&gt;Portainer install guide&lt;/a&gt;, as with Docker.&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; volume&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; create&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; portainer_data&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Creating the portainer data volume&lt;/em&gt;&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt; docker&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -d&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -p&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; 8000:8000&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; -p&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; 9443:9443&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; --name&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; portainer&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;--restart=always &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;\&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;-v &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/var/run/docker.sock:/var/run/docker.sock&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;-v &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;portainer_data:/data&lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;portainer/portainer-ce:latest&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;em&gt;Creating and running the Docker container&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;Just going through that command to understand what you’re running:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;The ports 8000 and 9443 are exposed, both in the container and to the host as the same port internally as externally.&lt;/li&gt;
&lt;li&gt;The container is named “portainer”.&lt;/li&gt;
&lt;li&gt;Portainer is set up to always restart - for example, when the machine boots or when the container crashes.&lt;/li&gt;
&lt;li&gt;The docker socket (/var/run/docker.sock) is mounted as a volume in the container. This makes sense, as Portainer is essentially a GUI for Docker.&lt;/li&gt;
&lt;li&gt;The previously created portainer_data volume is mounted as /data within the container.&lt;/li&gt;
&lt;li&gt;The container is the latest version of portainer-ce from the portainer repo from the Docker Hub. (CE stands for community edition.)&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;At this point, you should be able to put (your server’s local IPV4 address):9443 in your browser to get to the first time setup page for Portainer. You’ll create a user and connect Portainer to your local Docker environment as part of this process.&lt;/p&gt;
&lt;h2 id=&quot;installing-the-first-app&quot;&gt;Installing The First App&lt;/h2&gt;
&lt;p&gt;I handle my server as a &lt;a href=&quot;https://www.portainer.io/blog/stacks-docker-compose-the-portainer-way&quot;&gt;stack&lt;/a&gt; within Portainer. You could also just have a docker-compose.yml file that you update through the command line, but I personally use one central Portainer stack:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-1024x359.png.webp&quot; width=&quot;1024&quot; height=&quot;359&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-1024x359.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;To create a stack, click the “Add Stack” button from within Portainer.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-1-1024x560.png.webp&quot; width=&quot;1024&quot; height=&quot;560&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-1-1024x560.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I used to have my main docker compose file in a git repo, but that didn’t last very long because I was storing the git repo in a container that was part of the stack that was being deployed. Theoretically it may have been fine, but I had some deployment issues and was trying to eliminate variables, so I manually copy and paste my docker compose file.&lt;/p&gt;
&lt;p&gt;I personally use Microsoft’s open source code editor, &lt;a href=&quot;https://code.visualstudio.com/&quot;&gt;VS Code&lt;/a&gt;, to work with my Docker Compose files. It’s available on Mac, Windows, Linux, and now it’s available in the web browser at &lt;a href=&quot;https://vscode.dev&quot;&gt;https://vscode.dev&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-3-1024x576.png.webp&quot; width=&quot;1024&quot; height=&quot;576&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-3-1024x576.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Plus it’s so pretty too!&lt;/p&gt;
&lt;p&gt;The first app I implemented in Docker Compose was a reverse proxy through &lt;a href=&quot;https://nginxproxymanager.com/&quot;&gt;Nginx Proxy Manager&lt;/a&gt;. A reverse proxy acts like a traffic director for your locally hosted web applications. You give the reverse proxy full control of your web ports (80 for http, 443 for https). A reverse proxy also can handle SSL encryption for you in one centralized place rather than per app.&lt;/p&gt;
&lt;p&gt;Nginx requires a MySQL database to store information. Docker is &lt;em&gt;ideally&lt;/em&gt; stateless, meaning you can dump in your docker-compose file and get a working stack on any machine. Some blogs recommend having a separate database container per app (which seems like a waste of resources) or having your database outside of Docker. I ignore those recommendations for convenience[’s] sake and have one central database container.&lt;/p&gt;
&lt;p&gt;MariaDB is a fully open source alternative to MySQL, which is dual licensed. For almost all situations, MySQL and MariaDB are entirely compatible. I deployed my MariaDB container using the following Docker Compose code:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;version&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;2&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;services&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  db&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;yobasystems/alpine-mariadb:latest&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;db&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;always&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MYSQL_ROOT_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;root-pass&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MYSQL_DATABASE&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;npm&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MYSQL_USER&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;npm&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      MYSQL_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;npm-pass&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/BigThiccums/ContainerConfigs/MariaDB/data/mysql:/var/lib/mysql&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;This is the backend database that our proxy will use. I recommend changing the passwords to something secure - I personally generate random passwords using Lastpass.&lt;/p&gt;
&lt;p&gt;To create the actual Nginx Proxy Manager container, append this to your Compose file:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;  npm&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;jc21/nginx-proxy-manager:latest&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;npm&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;always&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;80:80&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;443:443&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;81:81&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_MYSQL_HOST&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;db&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_MYSQL_PORT&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#79B8FF&quot;&gt;3306&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_MYSQL_USER&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;npm&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_MYSQL_PASSWORD&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;npm-pass&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DB_MYSQL_NAME&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&quot;npm&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;      DISABLE_IPV6&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;&apos;true&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/BigThiccums/ContainerConfigs/NPM/data:/data&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;/BigThiccums/ContainerConfigs/NPM/letsencrypt:/etc/letsencrypt&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#85E89D&quot;&gt;    depends_on&lt;/span&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#E1E4E8&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt;db&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;3306 is the default MySQL port. You’ll access your control panel from port 81, while the webserver will be on ports 80 and 443. In order to take advantage of your new reverse proxy, you’ll need to open ports 80 and 443 on your router. My personal router is an eero, so I opened it up there:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-4-1024x378.png.webp&quot; width=&quot;1024&quot; height=&quot;378&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-4-1024x378.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;This meant that if you accessed the public IP assigned by my ISP at ports 80 and 443, you would see the Nginx Proxy Manager welcome page:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-5-1024x540.png.webp&quot; width=&quot;1024&quot; height=&quot;540&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-5-1024x540.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;In order to take advantage of Nginx Proxy Manager, I recommend buying your own domain. There are many places you can buy a domain - &lt;a href=&quot;http://domains.google&quot;&gt;Google Domains&lt;/a&gt;, &lt;a href=&quot;https://namecheap.com&quot;&gt;Namecheap&lt;/a&gt;, or &lt;a href=&quot;https://godaddy.com&quot;&gt;GoDaddy&lt;/a&gt;. I personally use &lt;a href=&quot;https://cloudflare.com/&quot;&gt;Cloudflare&lt;/a&gt; to handle my domain needs - they offer domains at wholesale prices and have plenty of DNS tools. Not a sponsor, but I totally recommend their services. Once you have a domain, you can add a wildcard A record (*.example.com) to your domain as your public IP. If you choose to use Cloudflare, this means you no longer can take advantage of their DNS proxying services.&lt;/p&gt;
&lt;p&gt;Once yourdomain.com leads to the Nginx Proxy Manager page above, you can start adding hosts within your Nginx Proxy Manager panel. To get there, go to (Server’s Local IPV4):81. The software will ask you to create a new user to secure your proxy. Then it’s off to create your first host!&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-6.png.webp&quot; width=&quot;492&quot; height=&quot;543&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;Be sure to change the IP listed there to your server’s local IP.&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;This exposes your Nginx Proxy Manager panel to the public internet. Luckily you have the authentication set up, so there’s little reason to worry. However, exposing your server to the public internet does have security consequences. Your public IP can give a vague idea of where you live. If there are security vulnerabilities in any of the software you deploy, having ports open can provide a vector for attack. The risk is relatively small, but home-hosting isn’t without consequences.&lt;/p&gt;
&lt;p&gt;Go ahead and click save. Now try going to your newly created address.&lt;/p&gt;
&lt;p&gt;You might be able to just fine, or you might see a security warning. We haven’t yet set up encryption, so this is normal at this point.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-7-1024x545.png.webp&quot; width=&quot;1024&quot; height=&quot;545&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-7-1024x545.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Because of the settings I have on my domain, I can’t resolve a connection unless it is encrypted. We can set up SSL encryption within Nginx by going to the SSL tab at the top of the navigation bar:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-8-1024x105.png.webp&quot; width=&quot;1024&quot; height=&quot;105&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-8-1024x105.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;You would be surprised how often I need to circle things with arrows while writing end-user instructions while working IT. Or maybe you wouldn’t.&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-9-1024x159.png.webp&quot; width=&quot;1024&quot; height=&quot;159&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-9-1024x159.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;As with the A record, I recommend creating one wildcard certificate rather than many individual certificates. If you’re with Cloudflare like I am, the process is relatively simple. You can find your API key from Cloudflare Dashboard like so:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-10-1024x62.png.webp&quot; width=&quot;1024&quot; height=&quot;62&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-10-1024x62.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;Yes, I did download a &lt;a href=&quot;https://getgreenshot.org/&quot;&gt;screenshot software&lt;/a&gt; between last diagram and this one.&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-11-1024x177.png.webp&quot; width=&quot;1024&quot; height=&quot;177&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/image-11-1024x177.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Now that you have your Cloudflare API key, go click “Add SSL Certificate” and then “&lt;a href=&quot;https://letsencrypt.org/&quot;&gt;Let’s Encrypt&lt;/a&gt;”&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-12.png.webp&quot; width=&quot;500&quot; height=&quot;900&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;/p&gt;
&lt;p&gt;Fill out the details you need to. I added a certificate for my base domain (grantmclravy.com) and a wildcard subdomain (*.grantmclravy.com).&lt;/p&gt;
&lt;p&gt;Now you have some certificates. You can edit your previous host to add your fancy new SSL certificate.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/image-13.png.webp&quot; width=&quot;500&quot; height=&quot;393&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;/p&gt;
&lt;p&gt;I always like to force SSL when it’s available - there’s no point allowing yourself to accidentally send sensitive data over the unencrypted version of your website when an encrypted one is readily available.&lt;/p&gt;
&lt;p&gt;You can also add a proxy entry for the portainer portal using the exact same process. You already have the cert created, so just enter {yourserverip}:9443 in the proxy host, noting that Portainer by default uses self-signed SSL, so you would select https as your protocol rather than http.&lt;/p&gt;
&lt;p&gt;Now you’ve deployed an app using Docker Compose through Portainer! In my next post, I’ll talk about some other cool things you can get your server to do, including a way to handily work through digitizing your physical media library through Plex.&lt;/p&gt;
</content:encoded><category>Home Server</category></item><item><title>Building the Ultimate Home Server - Part Three - Why I Switched from TrueNAS to Ubuntu</title><link>https://grantmclravy.com/blog/2021/11/04/building-the-ultimate-home-server---part-three---why-i-switched-from-truenas-to-ubuntu/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2021/11/04/building-the-ultimate-home-server---part-three---why-i-switched-from-truenas-to-ubuntu/</guid><description>In my last blog post (approximately 4 months ago), I talked about the build process and the software installation of TrueNAS, an open-source Network Attached Storage (NAS) software based on FreeBSD. Since then, I have switched away from…</description><pubDate>Thu, 04 Nov 2021 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;In my &lt;a href=&quot;https://grantmclravy.com/blog/2021/07/02/building-the-ultimate-home-server---part-two---the-build-and-software-install/&quot;&gt;last blog post&lt;/a&gt; (approximately 4 months ago), I talked about the build process and the software installation of TrueNAS, an open-source Network Attached Storage (NAS) software based on FreeBSD. Since then, I have switched away from TrueNAS to Ubuntu Server. I genuinely liked a whole lot of TrueNAS, but there were several reasons that I switched to Ubuntu:&lt;/p&gt;
&lt;!-- more --&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/truenas-ubuntu-meme.png.webp&quot; width=&quot;850&quot; height=&quot;626&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/truenas-ubuntu-meme.png&quot;&gt;&lt;/p&gt;
&lt;h2 id=&quot;reason-1---truenas-is-designed-as-an-os-for-storage-appliances&quot;&gt;Reason #1 - TrueNAS is designed as an OS for storage appliances&lt;/h2&gt;
&lt;p&gt;When I picked TrueNAS as the operating system for my server, the primary goal was to be a Network Attached Storage (NAS) device to pull my terabytes of data off of Google Drive. As I started to play with server management as a hobby, the goal changed. In the business world, we call this “scope creep” - where the initial request is something manageable but additional feature requests end up pushing the system further than it was designed to be pushed.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/scope-creep.png.webp&quot; width=&quot;1000&quot; height=&quot;525&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/scope-creep.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;TrueNAS works very well as a simple way to set up ZFS pools with a web interface. It also has some cool ways to set up preconfigured software packages in FreeBSD jails. These FreeBSD jails gave me a taste of the types of software I could be playing with:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/truenas-plugins-1024x385.png.webp&quot; width=&quot;1024&quot; height=&quot;385&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/truenas-plugins-1024x385.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I started with Nextcloud, then Home Assistant, then Plex, then GitLab. I was obsessed. However, these preconfigured jails were often old versions of software that was back-ported to FreeBSD. Community support for these versions was not as solid as support for other native operating systems. This didn’t bother me at first, because I was busy playing with all the cool new features of TrueNAS.&lt;/p&gt;
&lt;h2 id=&quot;reason-2---im-not-scared-of-cli-anymore&quot;&gt;Reason #2 - I’m not scared of CLI anymore&lt;/h2&gt;
&lt;p&gt;As I was trying to get TrueNAS to work for increasingly complex workflows, including automation, I had to dip my toes into the command line. One of the reasons I had chosen TrueNAS in the first place was to avoid the command line, but Mr. Scope Creep necessitated pushing the OS past the web-GUI’s guardrails. I needed to manually move some files into my Nextcloud directly. Guess I needed to learn how to manipulate files using the CLI. (Rsync is a really cool command) I wanted to sync items directly from Google Drive to Nextcloud - turns out learning Rclone commands make it way easier to manage cloud storage. What used to take 10 to 15 clicks in a GUI can be accomplished with one command. Combine that with “cronjobs” - automatically running a specific command at a specific time - and I could automate processes far more simply than with a GUI or a desktop environment.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/matrix-code-1024x576.png.webp&quot; width=&quot;1024&quot; height=&quot;576&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/matrix-code-1024x576.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;I found myself SSH-ing into my server to manipulate things from the command line far more than I pulled up the web interface.&lt;/p&gt;
&lt;h2 id=&quot;reason-3---i-dipped-my-toes-in-a-little-bit-already&quot;&gt;Reason #3 - I dipped my toes in a little bit already&lt;/h2&gt;
&lt;p&gt;TrueNAS includes the bhyve hypervisor for installing virtual machines on your server. When I was reading tech blogs to find new cool software to install on my server, I discovered &lt;a href=&quot;https://tailscale.com/&quot;&gt;Tailscale&lt;/a&gt;. There was a FreeBSD port of the software, but I was unable to get it to work properly. I was itching to try it out, so I created a quick Ubuntu VM to test it out. I fell in love with Tailscale - more on that in a future post but I wasn’t able to run it natively on my server. I also got used to the Linux command structure through some of the fiddling I did with that Ubuntu VM.&lt;/p&gt;
&lt;p&gt;While playing with my Ubuntu VM, I also discovered the joys of a certain containerization format.&lt;/p&gt;
&lt;h2 id=&quot;reason-4---docker-is-incredible&quot;&gt;Reason #4 - Docker is incredible&lt;/h2&gt;
&lt;p&gt;Docker has not been ported to FreeBSD successfully yet, so I was unable to run containerized applications. The FreeBSD jail plugins for TrueNAS were often woefully out of date community ports, so I was forced to read documentation explaining how great this new feature was that I did not have. I learned about the Docker format when I installed Nginx Proxy Manager to test out combining a reverse proxy with Tailscale. (More on that later) Especially when deploying it with Docker compose involved setting up one config then running one command and an entire application was up in a matter of seconds.&lt;/p&gt;
&lt;p&gt;Soon all my FreeBSD jails became Docker containers in my Ubuntu VM. Then I had to mount the files from my main storage device into my VM to get them to be accessible in my containerized environment. I asked myself - what if I could just run ZFS on Ubuntu?&lt;/p&gt;
&lt;p&gt;With a simple command:&lt;/p&gt;
&lt;pre class=&quot;astro-code github-dark&quot; style=&quot;background-color:#24292e;color:#e1e4e8; overflow-x: auto;&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span style=&quot;color:#B392F0&quot;&gt;sudo&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; apt&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#9ECBFF&quot;&gt; zfsutils-linux&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;I was able to get ZFS running in my Linux VM. I had proven it could work - I just needed to make the switch. Originally I had considered using ZFS boot, but after reading about what could go wrong if I experience disk corruption on my main pool, I decided to install Ubuntu on the 120GB SSD I used as a read-write cache for my primary pool.&lt;/p&gt;
&lt;h2 id=&quot;docker-server-vs-a-server-with-docker&quot;&gt;Docker Server vs. a Server with Docker&lt;/h2&gt;
&lt;p&gt;I have transformed my server into a Docker server - every crucial app is now containerized and was created from one central Docker Compose file, including the blog you’re reading this post on. In future posts, I’ll discuss some of the intricacies of how I could get this system to work, and some of the resources I found particularly valuable while setting up this server.&lt;/p&gt;
</content:encoded><category>Home Server</category></item><item><title>Building the Ultimate Home Server - Part Two - The Build and Software Install</title><link>https://grantmclravy.com/blog/2021/07/02/building-the-ultimate-home-server---part-two---the-build-and-software-install/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2021/07/02/building-the-ultimate-home-server---part-two---the-build-and-software-install/</guid><description>In my last blog post, I talked about why I built a home server. I also went through the part selection process. Check it out here if you missed that post. This time, I’ll discuss the joys of actually putting a computer together and the…</description><pubDate>Fri, 02 Jul 2021 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;In my last blog post, I talked about why I built a home server. I also went through the part selection process. &lt;a href=&quot;https://grantmclravy.com/blog/2021/05/31/building-the-ultimate-home-server---part-one---part-selection/&quot;&gt;Check it out here if you missed that post.&lt;/a&gt; This time, I’ll discuss the joys of actually putting a computer together and the process of installing TrueNAS, a free open-source NAS software based on FreeBSD.&lt;/p&gt;
&lt;p&gt;Because I am blogging this after the fact rather than extemporaneously, I don’t have a ton of pretty pictures to show you of the building process. Please accept my apologies and enjoy this photo of Data intensely staring at his cat, Spot. (This is the only photo I saved to my phone on the day I built my server.)&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/data-loves-spot-1024x586.png.webp&quot; width=&quot;1024&quot; height=&quot;586&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/data-loves-spot-1024x586.png&quot;&gt;&lt;/p&gt;
&lt;p&gt;Even Androids love cats&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“You must talk to him. Tell him that he is a good cat, and a pretty cat.”&lt;/p&gt;
&lt;p&gt;- Data to Worf on how to cat-sit for Spot&lt;/p&gt;
&lt;/blockquote&gt;
&lt;!-- more --&gt;
&lt;p&gt;The first step was the hardest one - waiting for parts to come in the mail. Due to the wonderful joys of Amazon Prime shipping, the first item to arrive was my M.2 to SATA adapter. It actually came with 5 SATA cables, so it turns out I didn’t need to order those from Newegg. My order had already shipped, and you can never have too many spare cables sitting in a drawer unused. My cheapie SSD came in a padded envelope - I love how durable SSDs are compared to HDDs. Then it was the week-long wait while the Newegg order shipped from the warehouse in California to South Carolina. As much as I dislike that Amazon is the mega-corp that it is, the Prime shipping experience is just so nice. The day finally came, and I recruited some help to carry all the boxes from the BJU post office to my dorm room. The biggest box was the case - even though it’s a mITX case, it still came packaged very securely in thick hard foam. The five Seagate Expansion drives would be an exciting project. My friend &lt;a href=&quot;https://eliaswatson.dev/&quot;&gt;Elias&lt;/a&gt;, a computer science major, helped me with the HDD shucking process. I used this fancy toolkit my parents got me for Christmas:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/took-kit.jpg.webp&quot; width=&quot;750&quot; height=&quot;607&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/took-kit.jpg&quot;&gt;&lt;/p&gt;
&lt;p&gt;XOOL Precision Tool Kit&lt;/p&gt;
&lt;p&gt;Clearly a knock-off iFixit&lt;/p&gt;
&lt;p&gt;The plastic enclosure for the hard drive was attached with little tiny plastic clips on the edges. At first, I attempted to use the plastic prying tool (The wider black tool up above) or the plastic guitar picks. It kinda worked that way, but when I switched to the metal prying tools things were much easier. The first drive was definitely a struggle because I didn’t know where the clips were. Elias finished the first drive, so we had a pattern for finding them. Rather than attempting to pry horizontally the whole way along the drive, I pried vertically along where just the clips were. I also shucked my old 8TB Seagate Expansion drive. Installing 6 drives in sleds took a bit of time. I had my motherboard nearby, so I moved on to the classic computer building fun stuff. I installed the CPU with the stock cooler. The AMD stock cooler is fully RGB’d out, compared to the subdued case with no window. The rainbow puke is fully contained inside the black and silver case. I initially installed the 32GB of RAM I thought might have been the problem with my previous PC, Berthita.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“Placing faulty hardware inside a new enclosure does not magically fix faulty hardware.”&lt;/p&gt;
&lt;p&gt;— Common sense, something I seem to lack&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;After I started to experience some of the same memory cache swapping issues Berthita had, I swapped it for the RAM I discussed in my previous post that I bought off my neighbor Elias. My server isn’t necessarily reliable now, but I’m also constantly tinkering with software that pushes this consumer-grade hardware to the limits. Installing the little M.2 to 5x SATA adapter was a joy, simply because it’s a weird little piece of technology. I installed all the cables first, as suggested by some Amazon reviews. The adapter did not feel particularly durable, but it got the job done. I’m very grateful to Elias, because I also borrowed his SFX PSU while I waited for mine to come in the mail. It takes a special type of computer hardware nerd to have a spare SFX PSU sitting in a college dorm room. I installed my motherboard in the case before I plugged in my power supply cables, one of the classic PC-building blunders, so it was a little bit of a struggle installing cables, particularly that nasty little 8 pin CPU cable. Once I plugged all the SATA cables into the daughterboard on the drive cage, this tiny little case became a true rat’s nest of cables.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/StudioWiring.jpg.webp&quot; width=&quot;600&quot; height=&quot;448&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot;&gt;&lt;/p&gt;
&lt;p&gt;True rat’s nest&lt;/p&gt;
&lt;p&gt;I promise it’s not this bad&lt;/p&gt;
&lt;p&gt;It only took some &lt;em&gt;slight&lt;/em&gt; pressure to get the case to close. I had completed the hardware section of this journey. I had my software installation USB drive prepped — then the bell in the Bob Jones dorm rang. My 1:00 investing class was 10 minutes away, so I had to pull myself away from my exciting project to learn equally exciting risk management theory.&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;After my class, I headed to my job at the IT Assets warehouse at BJU, where I imaged computers. I talked to all my co-workers about how excited I was to build my server. After I deployed some computers to another department at BJU, my boss let me leave early to go play with my server some more. I raced back to my dorm room to start the software install.&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;I had decided to use TrueNAS as the software for my server earlier on. TrueNAS is an open-source storage-focused operating system based on FreeBSD. It uses a walled garden approach to software installation based on FreeBSD jails. TrueNAS plugins are just preconfigured jails with certain software installed. For example, I have a jail for Nextcloud, a jail for Plex, and a jail for my download client. Only the files that I directly map to the jail can be modified by the software in the jail. Plex has access to my media share, while Nextcloud does not. The download client can only place files in the completed downloads folder - it can’t access my main file storage.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/Prison.jpg.webp&quot; width=&quot;750&quot; height=&quot;500&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/Prison.jpg&quot;&gt;&lt;/p&gt;
&lt;h2 id=&quot;freebsd-jails&quot;&gt;FreeBSD jails&lt;/h2&gt;
&lt;p&gt;Like Docker containers, but entirely different&lt;/p&gt;
&lt;p&gt;TrueNAS, previously known as FreeNAS, is built on ZFS, the Zettabyte File System. ZFS offers incredible performance, security, and file error correction. ZFS offers RAID-like disk pooling without the need for a hardware RAID controller. For my five 14 TB disks, I pooled them in RAIDZ1, which sets one of the disks to be used for parity. That means one of my disks can go down without any data loss. I have a total storage capacity of 56TB in my main storage pool. I asked my friend Luke what to name my storage pool - he decided on the name Big Thiccums. Big Thiccums has 5 HDDs with the 120GB SSD write cache. I also installed my previous 8TB HDD into its own pool. TrueNAS threw up several warnings about data parity and redundancy with only one disk in a pool. All of my pools are fully encrypted. In order to get into my NAS, you need credentials. If the disks were removed from my NAS and placed in a new server, they would need the encryption key to recover the data.&lt;/p&gt;
&lt;p&gt;When I first set up my NAS, I was at Bob Jones University. BJU requires all devices to sign in using a web-based portal to assign the MAC address to the student account for internet tracking. Because TrueNAS is designed to be a NAS device, it does not include a GUI - that means no web browser to sign into the BJU network. I first just set up a simple network - an ethernet cord from the NAS to my PC with manually assigned IPs. This enabled me to do all the initial setup, but I couldn’t directly download any plugins from the NAS because there was no internet access.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/coding-1841550-1024x683.jpeg.webp&quot; width=&quot;1024&quot; height=&quot;683&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/coding-1841550-1024x683.jpeg&quot;&gt;&lt;/p&gt;
&lt;p&gt;A dangerous combo - A tech problem and a motivated computer nerd&lt;/p&gt;
&lt;p&gt;Because I knew that the authentication was a simple MAC address lookup, one attempt to get my NAS on the network was through MAC address spoofing. At first I tried spoofing my PC’s MAC onto the NAS’s network card, but that didn’t allow it access to internet. Elias suggested I try it the other way around, signing into the network from my NAS’s MAC spoofed onto my main computer. That didn’t seem to work initially. However, when I booted into my Linux VM, running on a VNET off the same network card, it was able to connect to the internet. Another way I could have connected my NAS to the network would be spoofing the MAC onto a new router, but this project had already taken enough of my money. Instead, I decided to wait the two weeks until I was done with Bob Jones and do all the fancy configuration at home.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“Patience is a virtue. One I certainly don’t have”&lt;/p&gt;
&lt;p&gt;— Someone impatient who really wanted to play with a fancy server instead of working on schoolwork&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Next post, I’ll discuss more of the software setup process, including some of the interactions between media management plugins and fun VPN connection things through a special piece of software called Tailscale.&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;Rat’s Nest image- Gael Mace, CC BY 3.0 &lt;a href=&quot;https://creativecommons.org/licenses/by/3.0&quot;&gt;https://creativecommons.org/licenses/by/3.0&lt;/a&gt;, via Wikimedia Commons&lt;/p&gt;
</content:encoded><category>Home Server</category></item><item><title>Building the Ultimate Home Server - Part One - Part Selection</title><link>https://grantmclravy.com/blog/2021/05/31/building-the-ultimate-home-server---part-one---part-selection/</link><guid isPermaLink="true">https://grantmclravy.com/blog/2021/05/31/building-the-ultimate-home-server---part-one---part-selection/</guid><description>Data makes the world go round. According to the International Data Corporation, a research company dedicated to studying how worldwide data is created, 59 zettabytes of data was created in 2020. That’s a ridiculous amount of information…</description><pubDate>Mon, 31 May 2021 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;Data makes the world go round.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://web.archive.org/web/20201128050135/https://www.idc.com/getdoc.jsp?containerId=prUS46286020&quot;&gt;According to the International Data Corporation,&lt;/a&gt; a research company dedicated to studying how worldwide data is created, 59 zettabytes of data was created in 2020. That’s a ridiculous amount of information, and it takes vast numbers of huge datacenters all across the globe to store it somewhere. I personally have a huge amount of data I’ve created since I’ve started using personal computers at age 4. Because of this ever-increasing amount of data I have created, a few years ago, I decided to sign up for the Google Drive for Business unlimited storage plan. In mid-2020, Google made the announcement that these plans would no longer be unlimited. By that point, I had uploaded near 13TB of data to Google Drive and I needed somewhere to put it.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“I might be considered a digital hoarder.”&lt;/p&gt;
&lt;p&gt;— Me, If I’m being honest&lt;/p&gt;
&lt;/blockquote&gt;
&lt;!-- more --&gt;
&lt;p&gt;I don’t believe in deleting files. Do I truly need a third take from a film project from 2017? Probably not. I have backups from hard drives from every computer I’ve personally owned. I have copies of every family photo in multiple places just in case one of the hard drives I have it stored on fails. My personal Google Drive is backed up to another Google Drive provided to me with unlimited storage from Cedarville University from that one time I took three classes there. I’m pretty sure Google hates me, but they still get my money every month.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“But why couldn’t I just own my data?”&lt;/p&gt;
&lt;p&gt;— Also me, when trying to justify this project&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;One reason I decided to build my own home server was because of the idea of digital independence - owning the data I’ve created physically rather than trusting it to some cloud provider. Rather than the data being stored “in the cloud” - in some datacenter where I have no idea where it is, I could have my files on a server right next to my PC.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“Also, owning a server is just really cool!”&lt;/p&gt;
&lt;p&gt;— A nerd who likes playing with technology&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;So how would a college kid with no server building experience handle building a machine like this?&lt;/p&gt;
&lt;h2 id=&quot;my-goals--philosophy-for-my-server-build&quot;&gt;My Goals / philosophy for my server build&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;Recycle as much as possible from my previous PC. My previous computer seemed to have issues. From drive caching issues to random shutdowns to overheating, this PC would not seem to work properly, despite having decent hardware. As I replaced different parts yet issues persisted, I amassed a collection of perfectly functional computer hardware that was &lt;em&gt;almost a full computer&lt;/em&gt; but not quite. When I decided to go forward with the home cloud server due to a hard drive sale, I used my computer part graveyard as a starting ground.&lt;/li&gt;
&lt;li&gt;Keep this server small and portable. As a college student, I move around quite a bit. From dorm room to my parents’ place to my (eventual) apartment, I didn’t want a big chonky computer that is difficult to move.&lt;/li&gt;
&lt;li&gt;Be crazy adjustable. I wanted this server to do a ton of different things, not just be a network-attached-storage (NAS) device. I was hoping to be able to spin up virtual machines (VMs,) manage home automation, store files, play media, and run websites. Overall, I wanted this server to be a tool for me to learn cool nerdy IT stuff.&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;h2 id=&quot;the-parts&quot;&gt;The parts&lt;/h2&gt;
&lt;p&gt;&lt;em&gt;Click any of the images to go buy them yourself! I don’t do referral links or anything like that - these are just products I personally bought and like. I’ve linked the retailers that I personally bought from, but you should definitely price compare before pulling the trigger.&lt;/em&gt;&lt;/p&gt;
&lt;h3 id=&quot;the-drives&quot;&gt;The drives&lt;/h3&gt;
&lt;p&gt;The most important part of any file storage server is where the files will actually be stored. A sale on 14TB Seagate Expansion drives from Newegg was actually what prompted me to pull the trigger of actually building the server (combined with my stimulus check burning a hole in my pocket.)&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/Drives.jpeg.webp&quot; width=&quot;640&quot; height=&quot;480&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/Drives.jpeg&quot;&gt;&lt;/p&gt;
&lt;p&gt;Seagate Expansion 14TB Newegg had a sale where a $420 drive was selling for $230, so the natural response was to buy 5 of them.&lt;/p&gt;
&lt;p&gt;Buying these external hard drives is a great way to get hard drives far cheaper than buying a-la-carte. I shucked these drives and was pleasantly surprised to find Seagate Exos Enterprise drives inside, which retail on Amazon for ~$500. Paying $1150 for 70TB instead of $2500 is certainly preferable.&lt;/p&gt;
&lt;h3 id=&quot;the-case&quot;&gt;The case&lt;/h3&gt;
&lt;p&gt;In order to fit all these drives in a tiny chassis, I needed to find a specialized NAS case. You can’t just chuck five 3.5in hard drives in a normal small-form-factor PC case. Through researching, I came across this beauty:&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/case.jpeg.webp&quot; width=&quot;640&quot; height=&quot;480&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/case.jpeg&quot;&gt;&lt;/p&gt;
&lt;p&gt;SilverStone DS380B 8 drive sleds in a tiny mITX chassis? Yes, please!&lt;/p&gt;
&lt;p&gt;Though this case was quite pricey at $200 and was designed in 2014, it checked all the boxes for what I was looking for. The black brushed aluminum front looks quite nice, although the back is plain gray stainless steel that looks like generic Dell office machine. I attribute this to older PC building sensibilities from 2014, plus this case is likely a low-volume, high-margin product for nerds like me.&lt;/p&gt;
&lt;h3 id=&quot;m2-to-sata-3-adapter&quot;&gt;M.2 to SATA 3 adapter&lt;/h3&gt;
&lt;p&gt;Because I was building a small form factor computer, I needed to use a Mini-ITX motherboard. That meant that I wouldn’t have tons of SATA ports like modern ATX boards typically do. Luckily for me, through the wonders of Amazon sellers providing every possible product known to man, I found this M.2 to SATA adapter:&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://smile.amazon.com/dp/B07T3RMFFT&quot;&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/sata%20adapter.jpg.webp&quot; width=&quot;1000&quot; height=&quot;1376&quot; alt=&quot;&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/sata%20adapter.jpg&quot;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;IO CREST M.2 to SATA When you need more disks than you have sense&lt;/p&gt;
&lt;p&gt;The rest of these parts are ripped from my PC graveyard when I was fixing my small form factor gaming PC, &lt;a href=&quot;https://pcpartpicker.com/user/grantm56/saved/Z9KbLk&quot;&gt;Berthita.&lt;/a&gt;&lt;/p&gt;
&lt;h3 id=&quot;cpu&quot;&gt;CPU&lt;/h3&gt;
&lt;p&gt;Because this is more than just a NAS to transfer files, I wanted a CPU with a little more &lt;em&gt;oomph.&lt;/em&gt; A Ryzen 7 3700x is probably a bit overpowered for what I’m using it for right now, but it allows me room to grow and play with Plex, VMs, and other toys. I kept the stock cooler because I don’t plan to push it crazy hard right now.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/CPU.jpg.webp&quot; width=&quot;750&quot; height=&quot;750&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/CPU.jpg&quot;&gt;&lt;/p&gt;
&lt;p&gt;Ryzen 7 3700x 8 cores for all kinds of fun server goodness&lt;/p&gt;
&lt;h3 id=&quot;motherboard&quot;&gt;Motherboard&lt;/h3&gt;
&lt;p&gt;Why go with an Asrock B550M Mini-ITX? Because it’s what I had in my technology drawer in my dorm room.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/mobo.jpg.webp&quot; width=&quot;750&quot; height=&quot;750&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/mobo.jpg&quot;&gt;&lt;/p&gt;
&lt;p&gt;Asrock B550M Mini-ITX A fancy little MoBo for a fancy little server&lt;/p&gt;
&lt;h3 id=&quot;power-supply&quot;&gt;Power supply&lt;/h3&gt;
&lt;p&gt;Small form factor computers need small power supplies. Since I wouldn’t have a power-hungry GPU like the new 3000-series from NVIDIA, I didn’t need a ton of power for the NAS. However, I did plan on installing a 3080 in my main PC… if I could only find one. I upgraded Berthita to a CoolerMaster 850w SFX Gold in preparation for the day when plebs like me can obtain cards like that. My server got the hand-me-down EVGA SuperNOVA 650w SFX gold.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/psu.jpg.webp&quot; width=&quot;750&quot; height=&quot;750&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/psu.jpg&quot;&gt;&lt;/p&gt;
&lt;p&gt;EVGA 650W SFX Gold More juice than I’ll ever need&lt;/p&gt;
&lt;h3 id=&quot;random-access-memory&quot;&gt;Random Access Memory&lt;/h3&gt;
&lt;p&gt;Besides being the &lt;a href=&quot;https://www.youtube.com/watch?list=PLSbDLF8wQ3oKcstd9ybCSv2lNm_8NTYkI&amp;amp;v=IluRBvnYMoY&quot;&gt;greatest album of all time,&lt;/a&gt; RAM is the one part that I’m probably going to upgrade in the future. I went with 16GB of Corsair Vengeance LPX DDR4-3600 because my friend down the hall was willing to sell it to me.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/dedotated_wam.jpg.webp&quot; width=&quot;750&quot; height=&quot;343&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/dedotated_wam.jpg&quot;&gt;&lt;/p&gt;
&lt;p&gt;16 GB Corsair Vengeance LPX DDR4-3600 &lt;a href=&quot;https://www.youtube.com/watch?v=_pVNvSuA2mM&quot;&gt;What’s the wecomended amount of dedotated wam I shuddave for a servuh?&lt;/a&gt;&lt;/p&gt;
&lt;h3 id=&quot;ssd-cache&quot;&gt;SSD Cache&lt;/h3&gt;
&lt;p&gt;I probably don’t need an SSD cache, but I got a cheap 120GB SSD from Kingston off Newegg for $20 when I ordered the drives anyway.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/ssd.jpeg.webp&quot; width=&quot;750&quot; height=&quot;563&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/ssd.jpeg&quot;&gt;&lt;/p&gt;
&lt;p&gt;Kingston A400 120GB SSDs are crazy cheap now&lt;/p&gt;
&lt;h3 id=&quot;gpu&quot;&gt;GPU&lt;/h3&gt;
&lt;p&gt;Because the Ryzen 3700x is a Gamer CPU™ that doesn’t have integrated graphics, I needed a GPU to get a display out to configure the NAS for the first time. I went with a GT210 off Ebay for $20. Useful for getting a display out of a computer and not much more, but it does exactly what I need it to.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://grantmclravy.com/blog/images/w1200/GPU.jpg.webp&quot; width=&quot;751&quot; height=&quot;471&quot; alt=&quot;Image&quot; loading=&quot;lazy&quot; decoding=&quot;async&quot; data-full=&quot;/blog/images/GPU.jpg&quot;&gt;&lt;/p&gt;
&lt;p&gt;EVGA Nvidia GT210 Technically a graphics card&lt;/p&gt;
&lt;p&gt;All these parts magically came together and the server works perfectly without a hitch… right?&lt;/p&gt;
&lt;p&gt;Obviously not, this is a computer. In my next part of this blog post series, I’ll go through the build process and the joys of software installation. If you’ve made it this far without your eyes glazing over,&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;You’re obviously a huge nerd like me&lt;/li&gt;
&lt;li&gt;I appreciate your time and attention!&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;I had a blast recounting my server part selection. If you have any questions, hit me up in the comments or contact me about it - I’d be glad to talk about it!&lt;/p&gt;
</content:encoded><category>Home Server</category></item></channel></rss>