nix-community/srvos
1
1
Fork 0
mirror of https://github.com/nix-community/srvos.git synced 2024-11-09 22:15:01 +03:00
Code Issues Packages Projects Releases Wiki Activity
NixOS profiles for servers [maintainer=@numtide]
484 Commits 8 Branches 0 Tags 7.5 MiB
Nix 92.5%
Shell 7.5%
695e82ce3d
Go to file
dependabot[bot] 695e82ce3d
build(deps): bump cachix/install-nix-action from 22 to 23 (#231) 
Bumps [cachix/install-nix-action](https://github.com/cachix/install-nix-action) from 22 to 23.
- [Release notes](https://github.com/cachix/install-nix-action/releases)
- [Commits](https://github.com/cachix/install-nix-action/compare/v22...v23)

---
updated-dependencies:
- dependency-name: cachix/install-nix-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2023-09-05 10:08:09 +02:00
.github build(deps): bump cachix/install-nix-action from 22 to 23 (#231) 2023-09-05 10:08:09 +02:00
dev flake.lock: Update 2023-09-04 01:23:15 +00:00
docs hcloud: add arm subprofile (#214) 2023-08-07 16:06:58 +02:00
nixos feat(github-runners): add 'nodeRuntimes' option 2023-09-05 01:11:21 +01:00
.envrc introduce dev flake 2023-04-03 16:10:38 +02:00
.gitignore predictable module locations 2023-02-24 11:47:49 +01:00
.mergify.yml add mergify 2023-07-06 06:51:35 +02:00
bors.toml ci: add aarch64-darwin 2023-06-19 15:41:21 +02:00
default.nix introduce dev flake 2023-04-03 16:10:38 +02:00
flake.lock flake.lock: Update 2023-09-04 00:04:41 +00:00
flake.nix apply deadnix (#224) 2023-08-24 10:31:22 +02:00
LICENSE Create LICENSE 2023-01-16 23:39:46 +01:00
mkdocs.yml docs: refactor 2023-04-14 16:04:43 +02:00
README.md README: add light commercial support offer 2023-08-23 14:07:05 +02:00
shell.nix introduce dev flake 2023-04-03 16:10:38 +02:00

README.md

SrvOS - NixOS profiles for servers

STATUS: stable

SrvOS is a collection of opinionated and sharable NixOS configurations.

As we learn more about NixOS in various deployments, we end up re-writing the same modules and configs. This is a way for us to speed up and share our setups.

Instead of supporting everything, our goal is to target certain verticals and make the support super smooth there.

Quick Usage

Add srvos to your flake.nix to augment your NixOS configuration. For example to deploy a GitHub Action runner on Hetzner:

{
  description = "My machines flakes";
  inputs = {
    srvos.url = "github:numtide/srvos";
    # Use the version of nixpkgs that has been tested to work with SrvOS
    # Alternativly we also support the latest nixos release and unstable
    nixpkgs.follows = "srvos/nixpkgs";
  };
  outputs = { self, nixpkgs, srvos }: {
    nixosConfigurations.myHost = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        # This machine is a server
        srvos.nixosModules.server
        # Deployed on the AMD Hetzner hardware
        srvos.nixosModules.hardware-hetzner-amd
        # Configured with extra terminfos
        srvos.nixosModules.mixins-terminfo
        # And designed to run the GitHub Actions runners
        srvos.nixosModules.roles-github-actions-runner
        # Finally add your configuration here
        ./myHost.nix
      ];
    };
  };
}

Documentation

The Documentation website shows more general usage, how to install SrvOS, etc...

To improve the documentation, take a look at the ./docs folder. You can also run nix run .#docs.serve to start a preview server on http://localhost:3000.

Contributing

Contributions are always welcome!

Commercial support

Looking for help or customization?

Get in touch with Numtide to get a quote. We make it easy for companies to work with Open Source projects: https://numtide.com/contact

License

MIT