Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ipetkov/dotfiles
My personal dotfiles, managed with Nix and home-manager
https://github.com/ipetkov/dotfiles
dotfiles home-manager nix nixos
Last synced: 3 months ago
JSON representation
My personal dotfiles, managed with Nix and home-manager
- Host: GitHub
- URL: https://github.com/ipetkov/dotfiles
- Owner: ipetkov
- License: unlicense
- Created: 2021-01-18T23:54:14.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-16T05:00:06.000Z (5 months ago)
- Last Synced: 2024-09-17T06:05:10.790Z (5 months ago)
- Topics: dotfiles, home-manager, nix, nixos
- Language: Nix
- Homepage:
- Size: 807 KB
- Stars: 15
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ipetkov's dotfiles
These are my personal dotfiles and NixOS/home-manager configurations for
setting everything up. I doubt anyone would even want to use this directly,
but feel free to use it for your own inspiration (or apply any workarounds for
issues I've hit...).
## Layout Structure
I've tried to organize things in a logical way, so for the time being,
things are structured as follows:
* `config`: contents which might represent the `~/.config` directory. Basically
"literal" configs and definitions which get linked/incorporated through home-manager
* `docs`: additional documentation files, mostly for myself, but may be useful to others
* `homeConfigurations`: top-level fully instantiated home-manager
configurations. Useful for having the CI cache the artifacts and make sure
that everything builds. Also includes a `module` attribute which allows for
importing/overriding the definition as needed.
* `homeManagerModules`: a collection of "common" home-manager modules which could be used
in other dependent flakes. They're definitely tailored to my own preferences though, and lack
robust options (like how home-manager might lay things out)!
* `lib`: collection of helper functions for doing things like crawling
directories and automatically making flake outputs of things
* `nixosConfigurations`: top level system configurations, named by machine/host name
* `nixosModules`: same as `homeManagerModules` but related to system configuration modules
* `pkgs`: my own package definitions which aren't available upstream
* `users`: common user definitions that can be reused across system configurations.
Normally this directory would have a `default.nix` module which defines user groups,
home directories, etc., and a `home.nix` module which contains the root of the
home-manager configurations for this user.
## Additional Documentation
* [Machine initialization](./docs/machine_init.md) - How to prepare a machine for NixOS installation
## Applying configuration changes
Applying configuration changes on a local machine can be done as follows:
```sh
cd ~/dotfiles
sudo nixos-rebuild switch --flake .
# This will automatically pick the configuration name based on the hostname
```
Applying configuration changes to a remote machine can be done as follows:
```sh
cd ~/dotfiles
nixos-rebuild switch --flake .#nameOfMachine --target-host machineToSshInto --use-remote-sudo
```