os/doc/api-reference-channels.md
2023-01-28 21:49:10 +01:00

77 lines
1.1 KiB
Markdown
Executable file

# Channels API Container
Configure your channels that you can use throughout your configurations.
> #### ⚠ Gotcha ⚠
>
> Devshell & (non-host-specific) Home-Manager `pkgs` instances are rendered off the
> `nixos.hostDefaults.channelName` (default) channel.
## channels
nixpkgs channels to create
_*Type*_:
attribute set of submodules or path convertible to it
_*Default*_
```
{}
```
## channels.\<name\>.config
nixpkgs config for this channel
_*Type*_:
attribute set or path convertible to it
_*Default*_
```
{}
```
## channels.\<name\>.input
nixpkgs flake input to use for this channel
_*Type*_:
nix flake
_*Default*_
```
"self.inputs.<name>"
```
## channels.\<name\>.overlays
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
_*Type*_:
list of valid Nixpkgs overlay or path convertible to its or anything convertible to it or path convertible to it
_*Default*_
```
[]
```
## channels.\<name\>.patches
patches to apply to this channel
_*Type*_:
list of paths
_*Default*_
```
[]
```