Repository files navigation

Thisnixpkgs extension, callednixcloud-webservices, focuses on ease of deployment of web-related technologies.

You should continue to read one of these documentations:

• nixcloud.webservices
• nixcloud.reverse-proxy
• nixcloud.email
• nixcloud.TLS
• nixcloud.container

It features the development stack we use athttps://nixcloud.io.

Continuous integration athttps://hydra.nixcloud.io/project/nixcloud-webservices

Depending on which NixOS version you're on you can get different channels ofnixcloud-webservices which are tested against different NixOS releases:

18.03 is obsolete:

#nix-channel --remove nixcloud-webservices

• update to 18.09, see instruction below
• also update thesystem.stateVersion = "18.09"; when you are at it

#nix-channel --add https://hydra.nixcloud.io/channel/custom/nixcloud-webservices/release-18.09/nixcloud-webservices#nix-channel --update

You can find nixcloud-webservices specific options in therelease-18.09 manual.

#nix-channel --add https://hydra.nixcloud.io/channel/custom/nixcloud-webservices/nixos-unstable/nixcloud-webservices#nix-channel --update

You can find nixcloud-webservices specific options in thenixos-unstable manual.

Simply append<nixcloud-webservices> to yourimports list and you're readyto go, for example:

{imports=[./hardware-configuration.nix<nixcloud-webservices>];# ... other options ...}

Alternatively if you want to hack on nixcloud-webservices, you can also Gitclone it with:

$git clone https://github.com/nixcloud/nixcloud-webservices

You import modules into your local system by adding the path to yourconfiguration.nix to theimports list. Like this:

{imports=[./hardware-configuration.nix/path/to/nixcloud-webservices];# ... other options ...}

If you don't want to clutter your local system you can use a VM:

nix-build '<nixpkgs/nixos>' --arg configuration '{ imports = [ ./modules ./config.nix ]; services.mingetty.autologinUser = "root"; }' -A vm

Note: You have to createconfig.nix manually, it contains basically the lines we put in/etc/nixos/configuration.nix in previous examples.

Note: This is for advanced users who know how VMs on NixOS work.

The license can be found inLICENSE.

For inquiries, please contact:

• Joachim Schielejs@lastlog.de
• Paul Seitzpaul.m.seitz@gmail.com

Many thanks to:

• https://www.internetsociety.org/ (Sponsor)
• ISOC.nl (Sponsor)
• Internet hardening fund (Sponsor)
• profpatsch (Early prototyping)
• aszlig (NixOS module system)
• uwap (Email abstraction)
• griff (Email abstraction)
• elias (nixcloud.TLS, email abstraction)
• clever (Helping with hydra.nixcloud.io)
• brauner (Help with LXC)
• leenaars (Requirements, testing, review)
• seitz
• qknight

Among all who didn't make it into this list! Thanks for helping with writing this!