---
title: Introduction
description: An overview of what this repository provides and what to expect.
---

## Foreword

This repository contains my **personal** configuration for my systems, so it's really important that you know it's **personal** and not everything will fit your needs.
Therefore most things will not work out of the box without some changes, so be warned!

:::caution
This configuration will **not** work if you do not change any of the [secrets](/guides/secrets/) since they are encrypted.
:::

Maybe consider donating to me if this config or docs have helped you. Donation
platforms in order of preference:

- [ko-fi](https://ko-fi.com/isabelroses)
- [GitHub Sponsors](https://github.com/sponsors/isabelroses)
- [liberapay](https://liberapay.com/isabelroses)
- [patreon](https://www.patreon.com/isabelroses)

## Mirrors

- [GitHub](https://github.com/isabelroses/dotfiles)
- [GitLab](https://gitlab.com/isabelroses/dotfiles)
- [Codeberg](https://codeberg.org/isabel/dotfiles)
- [iztea](https://git.isabelroses.com/isabel/dotfiles)
- [tangled](https://tangled.org/@isabelroses.com/dotfiles)

## Futher Reading

A collection of resources, configurations, and people worth thanking.

### Resources

A collection of resources from people who just make good stuff.

- [nix.dev](https://nix.dev/) — a very good place to learn about the nix cli and lang
- [official wiki](https://wiki.nixos.org/wiki/NixOS_Wiki)
- [noogle](https://noogle.dev/) — nixpkgs lib docs
- [nix.ee](https://nix.ee) — littrally does everything
- [Nix Pills](https://nixos.org/guides/nix-pills/) — this one might be a bit much if you don't care too much about the internals
- [Viper's blog](https://ayats.org/)
- [Solène's blog](https://dataswamp.org/~solene)
- [Jade Lovelace's blog](https://jade.fyi/)
- [Astrid's blog](https://astrid.tech/t/nixos)
- [cafkafk's blog](https://point.free/)
- [zimbatm's blog](https://zimbatm.com/notes)
- [my own blog](https://isabelroses.com/blog)
- [zero to nix](https://zero-to-nix.com/start)
- [Xe's blog](https://xeiaso.net/blog/)

### Projects / configurations

These are some configurations or projects that I have taken inspiration from, or find to be of high quality, that people should also consider reading.

- [lovesegfault/nix-config](https://github.com/lovesegfault/nix-config)
- [jakehamilton/config](https://github.com/jakehamilton/config)
- [flake parts](https://flake.parts/)
- [nixos-hardware](https://github.com/NixOS/nixos-hardware)
- [getchoo/flake](https://github.com/getchoo/flake)
- [uncenter/flake](https://github.com/uncenter/flake)
- [lilyinstarlight/foosteros](https://github.com/lilyinstarlight/foosteros)

### People

Thanks to all these people; otherwise this config and I would be lost.

- [getchoo](https://github.com/getchoo) — for making catppuccin/nix and helping a ton
- [nullishamy](https://github.com/nullishamy) — for tricking me into using NixOS
- [nekowinston](https://github.com/nekowinston) — for fixing half my problems
- [jakehamilton](https://github.com/jakehamilton) — for teaching me too much about modules
- [nyxkrage](https://github.com/nyxkrage) — for being there to answer my questions
- [NotAShelf](https://github.com/notashelf) — lots of valuable information
- [Minion3665](https://github.com/Minion3665) — for making me write better docs
- [comfysage](https://github.com/comfysage) — for the help with neovim
- [Thorn](https://git.avery.garden/thorn) — picrewnix????
