Document how to build a NixOS system toplevel

Open
  • Is something wrong?
#1,365 5 comments 2 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
38/100
Issue type
Documentation
Clarity
Needs clarification
Activity status
Stale
Tech stack
nixos
Domain
build-system, documentation

Research direction

Review Hydra's existing examples and documentation for NixOS build workflows, then identify where the system-toplevel use case belongs. Document how to build system toplevels and push the relevant artefacts to the local S3 store so deployed systems can retrieve them without building locally.

Written by the indexing model from the issue text.

Description

Is your feature request related to a problem? Please describe.

Hydra seems to be great for building nixpkgs, or a subset of this. I've deployed my own Hydra and have my own local S3 cluster and the two work great.

However, I do not wish to build the (multi-TB) entirety of nixpkgs as my systems deployments requires a significantly tiny number of packages within this.

Instead, I'd like to use Hydra to simply build my systems' toplevels and push the relevant artefacts to the S3 store - then my systems can pull those down without having to do any parts of the builds themselves.

However, this usecase isn't documented in the examples.

Dominant language
PLpgSQL
Stars
1.6k
Forks
365
Avg merge
15h 37m
Merged PRs (30d)
61

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from NixOS/hydra

All issues in NixOS/hydra

Similar issues

More Build System issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.