tritonshell/README.md

41 lines
1.4 KiB
Markdown
Raw Normal View History

2022-01-21 16:55:29 +00:00
# tritonshell
2022-02-01 01:58:49 +00:00
### a nix dev & ops shell for [triton](https://www.joyent.com/triton/compute) and [manta](https://www.joyent.com/triton/object-storage)
2022-02-01 00:59:09 +00:00
2022-02-01 03:04:19 +00:00
[![asciicast](https://asciinema.org/a/pIGfe11qb3r33WstkkFW7BSuF.svg)](https://asciinema.org/a/pIGfe11qb3r33WstkkFW7BSuF)
2022-02-01 00:59:09 +00:00
2022-02-01 03:04:19 +00:00
0. If you're already on NixOS and / or have worked with `flakes` before, jump to **2.**
2022-02-01 01:58:49 +00:00
1. [Install nix, the package manager](https://nixos.org/download.html)
1. Now, make sure you're ready to `nix` with flakes, this should give you
some output:
2022-02-01 00:59:09 +00:00
```
nix flake --help
```
2. Otherwise, proceed to enable flakes (still an experimental feature in
`nix`):
2022-02-01 00:59:09 +00:00
https://nixos.wiki/wiki/Flakes#Installing_flakes
2022-02-01 01:58:49 +00:00
2. Get this nix flake template, it will be setup in a new directory
`./tritonshell` (feel free to adjust this):
2022-02-01 00:59:09 +00:00
```
2022-02-09 10:37:04 +00:00
nix flake new --template "git+https://git.greenbaum.cloud/dev/tritonshell?ref=main" ./tritonshell
2022-02-01 01:58:49 +00:00
cd tritonshell
2022-02-01 00:59:09 +00:00
```
2022-02-01 01:58:49 +00:00
2022-02-01 00:59:09 +00:00
3. Ready to go:
```
nix develop
```
2022-02-01 01:58:49 +00:00
**Optional**:
If you'd like to customize your new tritonshell with additional packages, you
can do so: just edit `flake.nix` and look for `extraDevshellPkgs`. Packages
added here will be pulled from the `nixos-unstable` channel, you can [search
for available packages here](https://search.nixos.org/packages?channel=unstable&from=0&size=50&sort=relevance&type=packages&query=hello).
2022-02-01 01:58:49 +00:00
TODO: add `nix-direnv`