DISNIXOS-QUERY(1)

📦 version 0.9.4, in nixos 26.05, nixpkgs unstable

💅 DISNIXOS-QUERY 💅

okay bestie, so this is a page from the User Commands manual — like, the DISNIXOS-QUERY(1) corner of the disnixos universe. sit down, grab a strawberry drink 🍓, and let's get into it.

✨ NAME ✨

disnixos-query — the girl whose whole job is querying the installed services from machines. like, she goes around asking "hey what's running" and reports back. icon behavior, honestly.

🦋 SYNOPSIS 🦋

disnixos-query [OPTION] network_nix [ network2_nix ... ]

lowkey simple: you give her options, and then one or more network_nix files, and she does her thing. plural networks, bestie — she can handle more than one. main character energy 💅

🌸 DESCRIPTION 🌸

so the way that disnixos-query works is: it collects and displays all the installed services from the machines defined in a given infrastructure model. that's it, that's the whole vibe. she pulls up to the infrastructure model, sees which machines are in there, and comes back with the receipts on what's installed. no cap. 🫶

🎀 OPTIONS 🎀

  • -p, --profile=PROFILE — the name of the profile where the services are registered. defaults to: default. so if you don't say anything, she assumes default, because of course she does 💖
  • --interface=INTERFACE — the path to the executable that talks to a Disnix interface. defaults to disnix-ssh-client. it's the little messenger she sends out, iykyk.
  • --target-property=PROP — the target property of an infrastructure model that specifies how to connect to the remote Disnix interface. defaults to hostname. basically: "which field in the model tells me where to go?" and by default it's hostname. periodt. 🔥
  • -f, --format=FORMAT — the output format, bestie, this is the aesthetic choice. options are: services (default), containers, nix, and xml. pick your lewk ✨
  • --use-nixops — use NixOps instead of Disnix for infrastructure deployment. she's flexible like that, she's not gonna gatekeep deployment tools 🧚
  • -h, --help — shows the usage of this command to the user. your little "help me bestie" button 🎀
  • -v, --version — shows the version of this command to the user. she'll tell you how old she is, no shame 🌈

👑 ENVIRONMENT 👑

  • DISNIX_CLIENT_INTERFACE — sets the client interface (which defaults to disnix-ssh-client). same default as the --interface flag, but like, in env-var form. slay. 💜
  • DISNIX_TARGET_PROPERTY — specifies which property in the infrastructure Nix expression specifies how to connect to the remote interface (defaults to: hostname). yep, the env-var twin of --target-property. twinsies 🫶
  • 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). this one's doing double duty — coordinator machine and each target. highkey overachiever 😭💖
ngl bestie, if you set these env vars, you don't have to type the flags every single time. the convenience is giving self-care, fr fr.

Copyright © 2008-2022 Sander van der Burg

and that's the whole page! 🦋 this was disnixos-query from the disnixos 0.9.4 release, dated January 1980 (yes, really, that's the date on the tin 💀). go forth and query those services, bestie — you're gonna eat, no cap. 🎀✨🔥

📦 where this page comes from