a1b1348979
Change-Id: I22ca3d3960d23d5dfc1e20140c28de79896926aa Reviewed-on: https://cl.snix.dev/c/snix/+/30636 Tested-by: besadii Autosubmit: Axel Karjalainen <axel@axka.fi> Reviewed-by: Florian Klink <flokli@flokli.de>
90 lines
2.3 KiB
Markdown
90 lines
2.3 KiB
Markdown
---
|
|
title: "Building Snix"
|
|
slug: building
|
|
description: ""
|
|
summary: ""
|
|
date: 2025-03-14T14:14:35+01:00
|
|
lastmod: 2025-03-14T14:14:35+01:00
|
|
draft: false
|
|
weight: 11
|
|
toc: true
|
|
---
|
|
|
|
This document describes how to build the project locally, both for interactive
|
|
development as well as referring to it from Nix code (for example, to run one of
|
|
its binaries on your machine).
|
|
|
|
{{<callout>}}
|
|
Please check the [Contribution Guide]({{< relref "contributing" >}}) on how to
|
|
contribute after following this guide.
|
|
{{</callout>}}
|
|
|
|
### Requirements
|
|
- Ensure you have [Direnv][] installed and [hooked into your shell][direnv-inst].
|
|
- Ensure you have [Nix][] installed.
|
|
|
|
### Getting the sources
|
|
Snix is hosted in its own Forgejo instance, hosted on [git.snix.dev](https://git.snix.dev/snix/snix).
|
|
|
|
Check out the source code as follows:
|
|
|
|
```bash
|
|
git clone https://git.snix.dev/snix/snix.git
|
|
```
|
|
|
|
### Interactive development
|
|
```bash
|
|
direnv allow
|
|
```
|
|
|
|
This provides all the necessary tools and dependencies to interactively build
|
|
the source code, using `cargo build` etc.
|
|
|
|
### Building only
|
|
|
|
It is also possible to build the different Snix crates with Nix,
|
|
in which you don't need to enter the shell.
|
|
From the root of the repository, you can build as follows:
|
|
|
|
```bash
|
|
$ nix-build -A snix.cli
|
|
```
|
|
|
|
Alternatively, you can use the [`mg`][mg] wrapper from anywhere in the repository (requires the direnv setup from above):
|
|
|
|
```bash
|
|
mg build //snix:cli
|
|
```
|
|
|
|
This uses [crate2nix][] to build each crate dependency individually.
|
|
|
|
#### Binary cache for Development
|
|
|
|
If you want to fetch store paths built by CI, you can configure our
|
|
[Harmonia](https://github.com/nix-community/harmonia) deployment as a Nix substituter:
|
|
|
|
```nix
|
|
{
|
|
nix.settings.trusted-public-keys = [
|
|
"cache.snix.dev-1:miTqzIzmCbX/DyK2tLNXDROk77CbbvcRdWA4y2F8pno="
|
|
];
|
|
nix.settings.substituters = [
|
|
"https://cache.snix.dev"
|
|
];
|
|
}
|
|
```
|
|
|
|
Keep in mind there's no guarantees on paths being available, they get GC'ed
|
|
eventually.
|
|
|
|
|
|
### Further reading
|
|
Checkout the [Component Overview]({{< ref "/docs/components/overview" >}})
|
|
to learn more about the project structure.
|
|
|
|
|
|
[Direnv]: https://direnv.net
|
|
[direnv-inst]: https://direnv.net/docs/installation.html
|
|
[Nix]: https://nixos.org/nix/
|
|
[mg]: https://git.snix.dev/snix/snix/src/branch/canon/tools/magrathea
|
|
[crate2nix]: https://github.com/nix-community/crate2nix/
|