feat: add notes

LICENSE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright (c) 2025 Alex Lebens
+Copyright (c) 2026 Alex Lebens
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

renovate.json

@@ -5,7 +5,7 @@
         "mergeConfidence:all-badges",
         ":rebaseStalePrs"
     ],
-    "timezone": "US/Central",
+    "timezone": "America/Chicago",
     "labels": [],
     "prHourlyLimit": 0,
     "prConcurrentLimit": 0,

src/content/docs/applications/actual.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/actual
       icon: right-arrow
 ---
+
+# Purpose
+
+Budgeting and managing finances.
+
+# Notes
+
+Currently unused, need to setup bank integration or some other for of automation.

src/content/docs/applications/argo-cd.mdx

@@ -13,3 +13,17 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/argocd
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">Has an internal [Grafana Dashboard](https://grafana.alexlebens.net/goto/ffiq2at9b8p34d?orgId=1).</Aside>
+
+# Purpose
+
+Deploying and managing resources within Kubernetes clusters.
+
+# Notes
+
+Syncs from templates defined in the [infrastructure](https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/manifests/) repo, manifests branch. Deeply integrated with Gitea and the rendered manifests system.
+
+Also used as a dashboard for resources, mostly for logs and restarting deployments. This is also done in [Headlamp](https://docs.alexlebens.dev/applications/headlamp/), which is the full featured dashboard.

src/content/docs/applications/audiobookshelf.mdx

@@ -13,3 +13,13 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/audiobookshelf
       icon: right-arrow
 ---
+
+# Purpose
+
+Podcasts, Audiobbooks, and Books.
+
+# Notes
+
+Mostly for podcast archiving and listening to audiobooks. Backup for [Grimmory](https://docs.alexlebens.dev/applications/grimmory/) for books, but not primary.
+
+Kind of difficult to manage podcasts though, and the phone apps don't auto download to the phone.

src/content/docs/applications/authentik.mdx

@@ -13,3 +13,17 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/authentik
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [auth.alexlebens.dev](https://auth.alexlebens.dev)</Aside>
+
+<Aside type="tip">Has an internal [Grafana Dashboard](https://grafana.alexlebens.net/goto/efiq29z9u4dmob?orgId=1)</Aside>
+
+# Purpose
+
+Single sign on authentication for applications that support OIDC.
+
+# Notes
+
+Available at public, local, and Tailscale endpoints. Apps are configured for their like endppoints.

src/content/docs/applications/backrest.mdx

@@ -13,3 +13,13 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/backrest
       icon: right-arrow
 ---
+
+# Purpose
+
+Backup system for files on the NAS. For size contraint reasons, does not backup most video content.
+
+# Notes
+
+Must be manually configured in the app. Has been setup for targets at the remote - PiBox - or the Digital Ocean S3 buckets.
+
+Mainly just for irreplacable files.

src/content/docs/applications/bazarr.mdx

@@ -13,3 +13,11 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/bazarr
       icon: right-arrow
 ---
+
+# Purpose
+
+Downloads subtitles for Sonarr and Radarr managed files.
+
+# Notes
+
+Haven't setup properly or sure if subtitles are being downloaded. Since I don't use subtitles very often I have thought about removing this.

src/content/docs/applications/blocky.mdx

@@ -13,3 +13,17 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/blocky
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">Has an [Grafana Dashboard](https://grafana.alexlebens.net/goto/afiq277mq7mkge?orgId=1)</Aside>
+
+# Purpose
+
+Very fast and declarative config DNS with built in adblocking. Used for local domain name configuration as well.
+
+# Notes
+
+Deployments in cluster, on RaspberryPis, and the PiBox. Cluster and Tailscale use the cluster endpoint, clients use the RaspberyPis, and home network used the PiBox.
+
+DNS over TLS to Cloudflare servers and somewhat agressive blocking.

src/content/docs/applications/cert-manager.mdx

@@ -13,3 +13,15 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/cert-manager
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">Has an [Grafana Dashboard](https://grafana.alexlebens.net/goto/ffiq2il12bwn4b?orgId=1)</Aside>
+
+# Purpose
+
+Manages certificates inside the Kubernetes cluster.
+
+# Notes
+
+Commonly used automatic background service used by other services.

src/content/docs/applications/cilium.mdx

@@ -13,3 +13,17 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/cilium
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">Has a dedicated [Dashboard with Hubble](https://hubble.alexlebens.net/)</Aside>
+
+# Purpose
+
+Core networking service connecting nodes and pods together. Provides a metal LoadBalancer service.
+
+# Notes
+
+One of the most important apps in cluster. Any updates need special care to ensure success.
+
+Long term goals include migrating the Ingress/Gateway from [Traefik](https://docs.alexlebens.dev/applications/traefik/) to Cilium and using BGP for connecting to the network devices. I've tried this a few times, but networking isn't my strong suit.

src/content/docs/applications/cloudnative-pg.mdx

@@ -13,3 +13,19 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/cloudnative-pg
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">Has an [Grafana Dashboard](https://grafana.alexlebens.net/goto/cfiq33g3brj0gc?orgId=1)</Aside>
+
+# Purpose
+
+Operator that manages PostgreSQL deployments in cluster.
+
+# Notes
+
+A very important application since many core services and applications depend on PostgreSQL databases.
+
+Backups to the NAS with replication of the base backups to remote and DigialOcean S3 endpoints.
+
+Used in conjunction with [this](https://gitea.alexlebens.dev/alexlebens/helm-charts/src/branch/main/charts/postgres-cluster) Helm Chart to easily deploy and manage the application PostgreSQL instances.

src/content/docs/applications/coredns.mdx

@@ -13,3 +13,17 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/coredns
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">Has an [Grafana Dashboard](https://grafana.alexlebens.net/goto/dfiq3jh1ez0n4a?orgId=1)</Aside>
+
+# Purpose
+
+DNS server just for cluster services, such as pod and service routing.
+
+# Notes
+
+Upstreams to [Blocky](https://docs.alexlebens.dev/applications/blocky/) for external DNS queries and also to the [Tailscale](https://docs.alexlebens.dev/applications/tailscale-operator/) DNS server for Tailnet access.
+
+Deploys as part of the Talos upgrades, but managed by Helm chart for the above custom configuration.

src/content/docs/applications/dawarich.mdx

@@ -13,3 +13,13 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/dawarich
       icon: right-arrow
 ---
+
+# Purpose
+
+Alternative to Google Locations, does tracking using an Android app to provide location history.
+
+# Notes
+
+Requires the provided Android app for tracking.
+
+Need to import Google Location history

src/content/docs/applications/element-web.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/element-web
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [chat.alexlebens.dev](https://chat.alexlebens.dev)</Aside>

src/content/docs/applications/foldergram.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/foldergram
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [art.alexlebens.dev](https://art.alexlebens.dev)</Aside>

src/content/docs/applications/freshrss.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/freshrss
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [rss.alexlebens.dev](https://rss.alexlebens.dev)</Aside>

src/content/docs/applications/gitea.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/gitea
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [gitea.alexlebens.dev](https://gitea.alexlebens.dev)</Aside>

src/content/docs/applications/karakeep.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/karakeep
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [karakeep.alexlebens.dev](https://karakeep.alexlebens.dev)</Aside>

src/content/docs/applications/matrix-synapse.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/matrix-synapse
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [matrix.alexlebens.dev](https://matrix.alexlebens.dev)</Aside>

src/content/docs/applications/outline.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/outline
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [outline.alexlebens.dev](https://outline.alexlebens.dev)</Aside>

src/content/docs/applications/postiz.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/postiz
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [postiz.alexlebens.dev](https://postiz.alexlebens.dev)</Aside>

src/content/docs/applications/rybbit.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/rybbit
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [rybbit.alexlebens.dev](https://rybbit.alexlebens.dev)</Aside>

src/content/docs/applications/site-documentation.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/site-documentation
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [docs.alexlebens.dev](https://docs.alexlebens.dev)</Aside>

src/content/docs/applications/site-profile.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/site-profile
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [www.alexlebens.dev](https://www.alexlebens.dev)</Aside>

src/content/docs/applications/site-saralebens.mdx

@@ -0,0 +1,19 @@
+---
+title: Site Sara Lebens
+description: Personal site made with Astro for information about Sara Lebens.
+hero:
+  tagline: Personal site made with Astro for information about Sara Lebens.
+  image:
+    file: https://web-assets-3bfcb5585cbd63dc365d32a3.nyc3.cdn.digitaloceanspaces.com/alexlebens-net/logo-new-round.svg
+  actions:
+    - text: Source
+      link: https://gitea.alexlebens.dev/alexlebens/site-saralebens
+      icon: right-arrow
+    - text: Deployment Chart
+      link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/site-saralebens
+      icon: right-arrow
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [www.saralebens.com](https://www.saralebens.com)</Aside>

src/content/docs/applications/vaultwarden.mdx

@@ -13,3 +13,7 @@ hero:
       link: https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/clusters/cl01tl/helm/vaultwarden
       icon: right-arrow
 ---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>This app has public facing endpoint, at [passwords.alexlebens.dev](https://passwords.alexlebens.dev)</Aside>