1
0
Fork 0
mirror of https://github.com/LnL7/nix-darwin.git synced 2025-03-13 20:30:02 +00:00

add modules section to README

This commit is contained in:
Daiderd Jordan 2016-12-14 18:50:03 +01:00
parent 8a654cf2d9
commit 6bfe1bcf99
No known key found for this signature in database
GPG key ID: D02435D05B810C96
2 changed files with 102 additions and 3 deletions

103
README.md
View file

@ -26,7 +26,7 @@ This will link the system profile to `/run/current-system`, you have to create `
If you use a symlink you'll probably also want to add `services.activate-system.enable = true;` to your configuration.
> NOTE: the system activation scripts don't overrwrite existing etc files, etc files like `/etc/bashrc` won't be used by default.
Either modify the existing file to source/import the one from `/etc/static` or remove the file.
Either modify the existing file to source/import the one from `/etc/static` or remove it.
```bash
git clone git@github.com:LnL7/nix-darwin.git
@ -40,8 +40,8 @@ result/sw/bin/darwin-rebuild switch
## Example configuration
Checkout [modules/examples](https://github.com/LnL7/nix-darwin/tree/master/modules/examples) for some example configurations.
```nix
```nix
{ config, lib, pkgs, ... }:
{
@ -63,3 +63,102 @@ Checkout [modules/examples](https://github.com/LnL7/nix-darwin/tree/master/modul
}
```
## Modules
### system.defaults
A set of [modules](https://github.com/LnL7/nix-darwin/tree/master/modules/system/defaults) to manage macOS settings.
```nix
{
system.defaults.dock.autohide = true;
system.defaults.dock.orientation = "left";
system.defaults.dock.showhidden = true;
}
```
> NOTE: you have to restart the dock in order for these changes to apply. `killall Dock`
### environment.etc
Set of files to be linked in `/etc`, this won't overwrite any existing files.
Either modify the existing file to source/import the one from `/etc/static` or remove it.
```nix
{
environment.etc."foorc".text = ''
export FOO=1
if test -f /etc/foorc.local; then
. /etc/foorc.local
fi
'';
}
```
### launchd.daemons
Definition of launchd agents/daemons. The [serviceConfig](https://github.com/LnL7/nix-darwin/blob/master/modules/launchd/launchd.nix) options are used to generate the launchd plist file.
```nix
{
launchd.daemons.foo = {
serviceConfig.ProgramArguments = [ "/usr/bin/touch" "/tmp/foo.lock" ];
serviceConfig.RunAtLoad = true;
};
}
```
### services
A set of modules for predefined services, these generate the appropriate launchd daemons for you.
```nix
{
services.nix-daemon.enable = true;
services.nix-daemon.tempDir = "/nix/tmp";
}
```
### programs
A set of modules to manage configuration of certain programs.
```nix
{
environment.shellAliases.tm = "${pkgs}/bin/tmux";
programs.bash.enable = true;
programs.tmux.enable = true;
programs.tmux.enableSensible = true;
programs.tmux.loginShell = "${config.programs.bash.shell} -l";
}
```
### nixpkgs.config
This attribute set is used as nixpkgs configuration when using nix-darwin.
```nix
{
environment.systemPackages =
[ # Use vim_configurable from packageOverrides
lnl.vim
];
nixpkgs.config.allowUnfree = true;
nixpkgs.config.packageOverrides = self: {
lnl.vim = pkgs.vim_configurable.customize {
name = "vim";
vimrcConfig.customRC = ''
set nocompatible
filetype plugin indent on
syntax on
'';
};
};
}
```

View file

@ -138,7 +138,7 @@
--set __ETC_ZPROFILE_SOURCED "" \
--set __ETC_ZSHENV_SOURCED "" \
--set __ETC_ZSHRC_SOURCED "" \
--add-flags -f --add-flags /run/current-system/etc/tmux.conf
--add-flags -f --add-flags /etc/tmux.conf
'';
lnl.vim = pkgs.vim_configurable.customize {