DISNIX-DIAGNOSE(1)

📦 version 0.10.2, in nixos 26.05, nixpkgs unstable

🩺 DISNIX-DIAGNOSE(1) — the disnix-diagnose page, bestie edition 💅

okay so real quick housekeeping: this is a User Commands manual page for disnix-diagnose</p>, and it's lowkey a lifesaver. let's get into it 🫶

✨ NAME ✨

disnix-diagnose</p> — spawn a remote shell session to diagnose a service 🩺✨

🌸 SYNOPSIS 🌸

disnix-diagnose -S SERVICE [OPTION] [MANIFEST]

that's it. that's the whole vibe check. -S SERVICE is the main character here, everything else is optional ✨

🦋 DESCRIPTION 🦋

so what does it actually do? it spawns a remote shell session to a machine where the given service is deployed — and not just any shell, bestie, it comes pre-loaded with environment variables containing configuration settings 🎀

which means you can conveniently diagnose problems, or just execute arbitrary maintenance tasks like the icon you are 👑

ngl it's giving "ssh but with the receipts" and i'm obsessed.

💖 OPTIONS 💖

  • -S, --service — name of the service to connect to. this is the one you literally cannot skip, it's the whole point 🫶
  • --show-mappings — displays the targets and containers in which the service is hosted. receipts mode, activated 💅
  • -c, --container=CONTAINER — name of the container in which the mutable component is deployed 🍓
  • -t, --target=TARGET — specifies the target to connect to. pick your machine, pick your destiny ✨
  • --command=COMMAND — shell commands to execute. no interactive session? no problem, just hand it the commands and go 🌸
  • -p, --profile=PROFILE — name of the profile in which the services are registered. defaults to: default 👑
  • --coordinator-profile-path=PATH — path to the manifest of the previous configuration. by default this tool will use the manifest stored in the disnix coordinator profile instead of the specified one, which is usually sufficient in most cases 🧚 (so like… you probably don't need this one, but she's there if you do)
  • -h, --help — shows the usage of this command to the user. classic, beloved, never misses 💜
  • -v, --version — shows the version of this command to the user. for when you gotta know ⭐

🌈 ENVIRONMENT 🌈

  • DISNIX_PROFILE — sets the name of the profile that stores the manifest on the coordinator machine and the deployed services per machine on each target. (Defaults to: default) 💖
fr fr remember: this env var is doing double duty — coordinator side and target side. one var, two jobs, main character energy 😭

Copyright © 2008-2022 Sander van der Burg

so yeah, that's the page 💜 go diagnose something, slay, and remember: -S SERVICE is not optional, bestie.

disnix 0.10.2 🌟 — dated January 1980 (yes really, the timestamp is vintage, the tools are iconic) 🎀✨🦋
📦 where this page comes from