Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nix-community/srvos
NixOS profiles for servers [maintainer=@numtide]
https://github.com/nix-community/srvos
build-with-buildbot buildbot- nix nixos
Last synced: 24 days ago
JSON representation
NixOS profiles for servers [maintainer=@numtide]
- Host: GitHub
- URL: https://github.com/nix-community/srvos
- Owner: nix-community
- License: mit
- Created: 2022-12-01T16:34:50.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-13T15:12:29.000Z (7 months ago)
- Last Synced: 2024-04-14T16:06:25.375Z (7 months ago)
- Topics: build-with-buildbot, buildbot-, nix, nixos
- Language: Nix
- Homepage: https://nix-community.github.io/srvos
- Size: 2.5 MB
- Stars: 371
- Watchers: 14
- Forks: 16
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
```nix
{
description = "My machines flakes";
inputs = {
srvos.url = "github:nix-community/srvos";
# Use the version of nixpkgs that has been tested to work with SrvOS
# Alternatively 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](https://nix-community.github.io/srvos/) 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 develop .#mkdocs -c mkdocs serve` to start a preview server on .
## Contributing
Contributions are always welcome!
## License
[MIT](LICENSE)
---
This project is supported by [Numtide](https://numtide.com/).
We are a team of independent freelancers that love open source. We help our
customers make their project lifecycles more efficient by:
- Providing and supporting useful tools such as this one
- Building and deploying infrastructure, and offering dedicated DevOps support
- Building their in-house Nix skills, and integrating Nix with their workflows
- Developing additional features and tools
- Carrying out custom research and development.
[Contact us](https://numtide.com/contact) if you have a project in mind, or if
you need help with any of our supported tools, including this one. We'd love to
hear from you.