os/doc/api-reference-channels.md

77 lines
1.1 KiB
Markdown
Raw Normal View History

# Channels API Container
2023-01-28 20:49:10 +00:00
Configure your channels that you can use throughout your configurations.
> #### ⚠ Gotcha ⚠
2023-01-28 20:49:10 +00:00
>
> Devshell & (non-host-specific) Home-Manager `pkgs` instances are rendered off the
> `nixos.hostDefaults.channelName` (default) channel.
## channels
2023-01-28 20:49:10 +00:00
nixpkgs channels to create
2023-01-28 20:49:10 +00:00
_*Type*_:
attribute set of submodules or path convertible to it
2023-01-28 20:49:10 +00:00
_*Default*_
```
{}
```
## channels.\<name\>.config
2023-01-28 20:49:10 +00:00
nixpkgs config for this channel
2023-01-28 20:49:10 +00:00
_*Type*_:
attribute set or path convertible to it
2023-01-28 20:49:10 +00:00
_*Default*_
```
{}
```
## channels.\<name\>.input
2023-01-28 20:49:10 +00:00
nixpkgs flake input to use for this channel
2023-01-28 20:49:10 +00:00
_*Type*_:
nix flake
2023-01-28 20:49:10 +00:00
_*Default*_
```
"self.inputs.<name>"
```
## channels.\<name\>.overlays
2023-01-28 20:49:10 +00:00
overlays to apply to this channel
these will get exported under the 'overlays' flake output
as \<channel\>/\<name\> and any overlay pulled from \<inputs\>
will be filtered out
2023-01-28 20:49:10 +00:00
_*Type*_:
list of valid Nixpkgs overlay or path convertible to its or anything convertible to it or path convertible to it
2023-01-28 20:49:10 +00:00
_*Default*_
```
[]
```
## channels.\<name\>.patches
2023-01-28 20:49:10 +00:00
patches to apply to this channel
2023-01-28 20:49:10 +00:00
_*Type*_:
list of paths
2023-01-28 20:49:10 +00:00
_*Default*_
```
[]
```