Sanitized mirror from private repository - 2026-04-20 01:32:01 UTC

docs/services/individual/fenrus.md

@@ -0,0 +1,35 @@
+# Fenrus Dashboard - Font Customization Notes
+
+## Overview
+
+Fenrus is a self-hosted dashboard running on Guava (TrueNAS Scale).
+- Portainer: https://truenas-scale.tail.vish.gg:31015/#!/home
+- Persistent volume: `/mnt/data/fenrus:/app/data` (DB and encryption keys only)
+
+## Current Font
+
+- **Font**: Montserrat (variable font)
+- **File**: `/app/wwwroot/fonts/Montserrat-VariableFont_wght.ttf`
+- **CSS**: `/app/wwwroot/css/01_site.css` (lines ~5-12, `@font-face` + `html` selector)
+- Additional `font-family: "Montserrat"` references in SCSS source files
+
+## Custom CSS Support
+
+None. No built-in custom CSS injection, no font override in the theme system. Themes (`/app/wwwroot/themes/`) only control layout/placement via `theme.json`.
+
+## How to Change the Font
+
+1. Edit `@font-face` and `font-family` in `/app/wwwroot/css/01_site.css`
+2. Drop new font file (`.ttf` or `.woff2`) into `/app/wwwroot/fonts/`
+
+**Problem**: These files are inside the container image, NOT in the persistent volume. Changes are lost on container update.
+
+## Persistence Options
+
+1. **Entrypoint wrapper** (simplest) — script that patches CSS and copies font on every container start
+2. **Bind mount** — mount a custom CSS file over `/app/wwwroot/css/01_site.css`
+3. **Custom Docker image** (most robust) — `FROM fenrus` with font baked in
+
+## Status
+
+TODO — revisit later.