Skip Navigation

Getting started with NixOS - looking for tutorials

I heard a lot about the concepts of nix and NixOS and I'd love to try it.

After installing the VirtualBox demo, I keep getting stuck with every tiny step I take, though.

So I was wondering if there are any tutorials for beginners that you can recommend?

I couldn't find anything on the internet - everything that looks like a tutorial presumes a lot of things everybody seems to know about nix, so no need to explain those.

Where can I find those explanations to make the first baby steps with NixOS?

To put it in other words: Where is NixOS for dummies?

13

You're viewing a single thread.

13 comments
  • I'm using NixOS partly as a dev machine, but mostly for consumer OS stuff like gaming, YouTube, social media...

    What are you trying to use it for? From the consumer perspective, I feel like modifying configuration.nix would be the majority of what I need. It's like ninite if you've used that to setup a Windows machine, but it can be preloaded on your OS and you can configure everything, not just which programs are installed

    If you're trying to setup dev environments, I think what gets weird is how many ways there are to do similar things, like nix develop, nix build, nix shell...

    • Currently I am playing around in a virtual machine to get to know NixOS and find out what I can do with it.

      I'd like to set up a usable everyday desktop configuration with "everything".

      This includes typical desktop applications like Firefox, Thunderbird, LibreOffice ... development tools like Git, PyCharm, VS Code, ... all those little things I need to work productively like Nextcloud desktop client, KeePassXC, Zim and many more.

      And I'd like to have zsh as my default shell with my own custom theme and some dotfiles for different applications that currently reside in a git repo that I clone to every machine I use.

      I know this is a lot and I don't expect to get this all up and running in an afternoon.

      It's just that I find it very hard to find the next bit of information I need. For example I found snippets to put into my configuration.nix long before I found out where to find this file (/etc/nixos/configuration.nix).

      From the answers so far I gather that there really is no (official or unofficial) documentation to tell NixOs newbies how to start, so everyone just makes do with the things they find.

      So I think I'll just fight my way through this jungle, too ;-)
      The price that's waiting at the other and seems to be totally worth it!

      If anyone has valuable tips or links to help me achieve something from the things I listed, those would be very much appreciated! :-)

      • Yea it's definitely a jungle haha, it also seems they're changing things up a bit with where the most recent docs might be hosted

        https://search.nixos.org/

        so, if you searched for vscode in that link, then click the "NixOS Configuration" button, you can see

          environment.systemPackages = [
            pkgs.vscode
          ];
        

        or if you're using the with convention to factor out the pkgs object/contextual keyword(not sure if that's the right name)

          environment.systemPackages = with pkgs; [
            vscode
          ];
        

        for zsh, just having this in your configuration.nix should work https://nixos.wiki/wiki/Command_Shell

        programs.zsh.enable = true;
        users.defaultUserShell = pkgs.zsh;
        

        Again, these values should be inserted after the function definition of your configuration.nix

        { config, pkgs, ...}:
        {
           # Things get inserted here typically
           imports = [ ./hardware-configuration.nix];
           environment.systemPackages = [pkgs.vscode];
        }
        

        for example.

        Something I've noticed from developing on nix, When the headaches of nix appear, the solution might be harder, but I usually end up with a better solution than what I was going for before. Some examples:

        • My resume is compiled in Latex. I tried the pdflatex package in nix but it gave rendering issues. Then the nix community recommended tectonic and i'm getting better compilation times, logging, clean up...

        • PIP is a garbage package manager, and it's garbageness sometimes makes native python development a headache in nixos. However, using poetry2nix, not only could I define development environments, it was also ready for packaging on PIP

        Sometimes you might want to separate some parts of your configuration away from your global system config at /etc/nixos/configuration.nix. That's nix-shell, nix-develop, nix-build, and flakes are for. I'm not a pro at flakes yet, but I think I got the gist, here's an example of when I wish I could have used a flake:

        I use discord but discord itself is garbage. Vesktop is a better 3rd party client for discord. Unfortunately, I had to remove it from my configuration.nix the last few weeks because one of its dependencies wasn't packaged right, causing my entire system to not build. If I had used a flake, I could have isolated that dependency from the rest of my build, while still tracking its integration with my system. I believe this could have allowed me to update the rest of my system, while still defining the errenous app as part of my system. Flakes are supposed to be more reproducible as well, since they require sha256 git commits, whereas other package managers only ask for a subjective version number

        There's a lot to learn with nix but even if I don't stick with it long term I feel like It's making me a smarter software engineer since a declarative/functional paradigm tends to match the natural language more. It also is the most restrictive design paradigm, which means it's brief but so simple it can be hard to understand as a consequence. Since it's so restrictive, it's also a subset of all other paradigms. You declare what you want, ideally, you don't have to set anything up. I never had an easier time getting cuda drivers for ML Training setup than on NixOS because of this

        Something I enjoyed doing, was setting up my user profile to let me ssh in only with whitelisted ssh keys, as well as setting up a systemd script to handle some start up routines on my OS. I think that can be a gentle introduction to how you can configure other parts of your operating system. I'm going to try and set up a CI/CD/CT pipeline with it next I believe

        Edit: The next thing I need to do as well, is consolidate my user configs with the home manager functionality. I use a KVantum Theme engine on top of plasma, and while those apps are installed in my system, the configuration of which theme to automatically load should be integrated with the text config aspects of nixos. Currently, I "Imperatively" configured those by "Opening the app and clicking", which will get erased/not be reproducible if I ever rebuild my nixos on a new computer

        Another funny thing with functional programming... sometimes the fix is as simple as

        sound.enable = true;
        

        Even though I had pipewire enabled as a service and everything, that one line needed to be there haha

You've viewed 13 comments.