dotfiles/README.org

* magic_rb's dotfiles

** License

All files unless otherwise stated are licensed under the LGPL-v3.0 license. Please refer to [[file:COPYING][COPYING]] and [[file:COPYING.LESSER][COPYING.LESSER]] for more information.

*** Exceptions

The LGPL-v3.0 does not apply to you copying out a insignificant part of the source code, general rule of thumb is "If it's less than 32 lines and/or doesn't constitute a big self contained part, it's licensed under the MIT license." If you need clarification please contact ~@magic_rb:matrix.redalder.org~ on matrix.

** NixOS

*** Modules

**** ~acme-sh~
- source code: [[file:nixos/modules/acme-sh.nix]]

Modified version of module originally from [[https://github.com/serokell/serokell.nix/blob/master/modules/acme-sh.nix][Serokell]]. It allows to easy fetch and access certificates, facilitated by `acme-sh`. Can be used in tandem with any program which can load certificates from files.

**** ~grafana~
- source code: [[file:nixos/modules/grafana.nix]]

Very simplified version of module originally from [[https://github.com/NixOS/nixpkgs/blob/nixos-24.05/nixos/modules/services/monitoring/grafana.nix][nixpkgs]].

This module is currently *unused*, *untested*, and may be removed or completely reworked soon.

**** ~hashicorp-envoy~
- source code: [[file:nixos/modules/hashicorp-envoy.nix]]

Allows deploying Envoy proxies that can integrate with the Consul Connect service mesh. Used to hook klipper into the rest of my infrastructure.

This module is *deprecated* and *will* be removed soon. I'm switching away from Hashicorp Nomad+Consul and towards k3s+Istio and therefore won't have a need for this module.

**** ~hashicorp~
- source code: [[file:nixos/modules/hashicorp.nix]]

Runs Hashicorp Vault, Consul and Nomad. Would probably work with OpenBao too, but this has not yet been tested.

**** ~influx-provisioning~
- source code: [[file:nixos/modules/influx-provisioning.nix]]

Crudely provisions InfluxDB.

This module is *deprecated* and *will* be removed soon. It was originally created when I thought I would be switching away from Terraform completely. Now I know I will be switching to OpenTofu.

**** ~netboot-xyz~
- source code: [[file:nixos/modules/netboot-xyz.nix]]

Adds ~netboot.xyz~ to GRUB, supports both EFI and BIOS. Used on my server in case of catastrophic root pool failure.

**** ~notify-login~
- source code: [[file:nixos/modules/notify-login.nix]]

Send notifications over Matrix, when an SSH session is opened/closed.

**** ~notnft~
:PROPERTIES:
:ID:       2f6f4431-2e40-4540-871f-0a8c7c9bfd2d
:END:
- source code: [[file:nixos/modules/notnft.nix]]

Alternative implementation of upstream [[https://github.com/chayleaf/notnft][notnft]] module, which is part of the much larger [[https://github.com/chayleaf/nixos-router][nixos-router]] repository.

**** ~notnft-ns~
- source code: [[file:nixos/modules/notnft-ns.nix]]

Newer implementation of the [[id:2f6f4431-2e40-4540-871f-0a8c7c9bfd2d][notnft]] module, this one supports network namespaces.

**** ~telegraf~
- source code: [[file:nixos/modules/telegraf.nix]]

Very simplified version of module originally from [[https://github.com/NixOS/nixpkgs/blob/nixos-24.05/nixos/modules/services/monitoring/telegraf.nix][nixpkgs]].

This module is currently *unused*, *untested*, and may be removed or completely reworked soon.