MiauInv

A secure, light-weight, and minimalistic management system for tracking your inventory stock and project allocations.

Ein sicheres, pfeilschnelles und minimalistisches System für deine Lagerbestände und Projekt-Zuweisungen.

Go Backend HTMX Frontend SQLite Inside Docker Ready

Why MiauInv?

Warum MiauInv?

  • Zero JS-Overhead:Kein JS-Overhead: Powered by HTMX for an ultra-reactive, dynamic SPA experience without heavy client-side bundles. Dank HTMX extrem reaktiv und dynamisch wie eine SPA, aber ohne tonnenweise schweres JavaScript.
  • Live Quantities:Live-Verfügbarkeit: See overall totals, allocated project metrics, and remaining available counts instantly. Siehst sofort den Gesamtbestand, was in Projekten verplant ist und was noch frei zur Verfügung steht.
  • Unified Dashboards:Orte & Projekte im Blick: Drill straight down into site boundaries or project lists to inspect stock components with one click. Klicke auf Lagerorte oder aktive Projekte im Dashboard, um direkt den aktuellen Inhalt einzusehen.

Security & Tech Stack

Sicherheit & Tech

  • Dual-Token Security:Dual-Token Security: Uses robust cryptographically signed JWT cookies combined with seamless backend refresh token rotations. Zugriffsschutz über sichere, verschlüsselte JWT-Cookies inkl. Refresh-Token-Rotation.
  • Native TLS Listener:Native TLS Listener: Out-of-the-box enforced HTTPS transport layer security powered directly by Go's core networking. Enforcierte HTTPS-Verschlüsselung direkt aus dem Go-Core heraus.
  • Ultra Lightweight:Leichtgewicht: Runs on absolute minimal system footprint resource margins using an embedded optimized SQLite model. Minimaler Ressourcenverbrauch dank kompilierter Go-Binary und eingebetteter SQLite-Datenbank.

Install Your Server

Server installieren

Deploy MiauInv to your server infrastructure or local machine in less than a minute utilizing our streamlined container configurations.

MiauInv lässt sich dank vorkonfiguriertem Docker-Setup innerhalb weniger Sekunden auf deinem Server oder lokalen System starten.

1 Setup Asset Directories and TLS Ordner und Zertifikate vorbereiten

Since MiauInv natively enforces encrypted communication channels, initialize your tracking asset directory and place your TLS files there (or generate a self-signed keypair for testing targets):

Da MiauInv standardmäßig verschlüsseltes HTTPS erzwingt, erstelle den Appdata-Ordner und lege deine SSL-Zertifikate ab (oder generiere ein Self-Signed Cert für Tests):

mkdir -p appdata
openssl req -x509 -newkey rsa:4096 -keyout appdata/key.pem -out appdata/cert.pem -sha256 -days 365 -nodes -subj "/CN=localhost"

2 Configure Docker Compose Docker Compose Datei anlegen

Create a docker-compose.yaml layout file in the parent folder, and inject the orchestration service blocks. Ensure your JWT_SECRET environment variable meets the minimum security threshold length requirements:

Erstelle eine docker-compose.yaml im selben Verzeichnis und füge folgenden Inhalt ein. Passe den JWT_SECRET-String an:

services:
  miauinv:
    image: git.miaurizius.de/miaurizius/miauinv:latest
    container_name: MiauInv
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - JWT_SECRET=SECURE_RANDOM_STRING_HERE_MIN_32_CHARS
    volumes:
      - ./appdata:/appdata

3 Boot the Environment Container starten

Fire up the production background workers by executing your infrastructure controls daemon tasks:

Führe nun einfach den Start-Befehl aus, um das Image zu ziehen und im Hintergrund zu starten:

docker-compose up -d

Everything is set up! Your instance is running and fully accessible at https://localhost:8080.

Fertig! Dein Server läuft und ist sofort unter https://localhost:8080 erreichbar.