Support: Difference between revisions

Latest revision as of 23:25, 15 September 2024

This article outlines how to best go about getting support. It is recommended to make sure you try these measures in this order, moving on to the next measure only when the previous has been exhausted.

1. Check the documentation

In addition to the reference documentation and introductory materials on nix.dev, and NixOS user documentation in this Wiki, there is a wealth of unofficial documentation available. For an overview of all these resources, see our resource overview article. It is a good idea to look into the manual(s) too:

2. Have a chat

The #nix channel on the Matrix network is very active, and is one of your best shots at getting live support; if you don't have an Matrix client you can check out our Get In Touch page for alternatives.

3. Post your issue

If your issue is technical and possibly a bug, you can report the issue on the Nixpkgs GitHub repository. For other questions, you could try the official discourse instance, stack overflow, or the NixOS Reddit channel.

4. Hire a pro

If all else fails, you can hire a professional Nix consultant; see the list of Nix consultants

@@ Line 1: / Line 1: @@
-{{warning|text="This discussion article is incomplete, so contributions are welcome. Please consult the [[:Category:Reference|reference article metapage]] for guidelines on contributing to discussion articles."}}
+This article outlines how to best go about getting support. It is recommended to make sure you try these measures in this order, moving on to the next measure only when the previous has been exhausted.
+=== 1. Check the documentation ===
-[[Category:Reference]]
+In addition to the [https://nix.dev reference documentation and introductory materials on nix.dev], and NixOS user documentation in this Wiki, there is a wealth of unofficial documentation available. For an overview of all these resources, see our [[Resource Overview|resource overview]] article. It is a good idea to look into the manual(s) too:
+* [https://nixos.org/nixos/manual/ NixOS manual]
+* [https://nixos.org/nix/manual/ Nix manual]
+* [https://nixos.org/nixpkgs/manual/ Nixpkgs manual]
+* [https://nixos.org/hydra/manual/ Hydra manual]
+=== 2. Have a chat ===
+The [https://matrix.to/#/#nix:nixos.org #nix] channel on the [[Matrix]] network is very active, and is one of your best shots at getting live support; if you don't have an Matrix client you can check out our [[Get_In_Touch#Chat | Get In Touch page]] for alternatives.
+=== 3. Post your issue ===
+If your issue is technical and possibly a bug, you can [https://github.com/NixOS/nixpkgs/issues report the issue] on the [[Nixpkgs]] [https://github.com/NixOS/nixpkgs GitHub repository]. For other questions, you could try the official
+[http://discourse.nixos.org/ discourse] instance,  [https://stackoverflow.com/ stack overflow], or the [https://www.reddit.com/r/NixOS/ NixOS Reddit channel].
+=== 4. Hire a pro ===
+If all else fails, you can hire a professional Nix consultant; see the [[Nix Community#Consultants|list of Nix consultants]]
+[[Category:Guide]]
 [[Category:Community]]
-[[Category:Incomplete]]