templates/README.md

48 lines
2.7 KiB
Markdown
Raw Normal View History

2024-05-02 17:41:24 +00:00
<p align="center">
<h2 align="center">Welcome to Aux</h2>
</p>
2024-05-02 17:41:24 +00:00
<p align="center">
This is a template repository for getting started with your brand new Auxolotl system.
2024-05-02 17:41:24 +00:00
</p>
2024-05-01 21:20:47 +00:00
2024-05-02 17:41:24 +00:00
<p align="center">
<a href="https://forum.aux.computer/c/special-interest-groups/sig-documentation/21"><img src="https://img.shields.io/static/v1?label=Maintained%20By&message=SIG%20Documentation&style=for-the-badge&labelColor=222222&color=794AFF" /></a>
<a href="https://forum.aux.computer/c/special-interest-groups/sig-core/14"><img src="https://img.shields.io/static/v1?label=Maintained%20By&message=SIG%20Core&style=for-the-badge&labelColor=222222&color=794AFF" /></a>
</p>
&nbsp;
2024-05-01 21:20:47 +00:00
### Getting Started
There are 3 main templates in this repository:
- `darwin` - The system configuration for the Darwin operating system (macOS)
- `system` - A complete NixOS system configuration template for the Linux operating system
2024-05-01 21:20:47 +00:00
- `home-manager` - The configuration for the home-manager
#### With Darwin (macOS)
1. Run `nix --extra-experimental-features nix-command --extra-experimental-features flakes flake new -t github:auxolotl/templates#darwin NixFiles` in the terminal. This will setup the basic configuration for the system, this generate a configuration for you from the files located in the `darwin` directory.
2024-05-01 21:20:47 +00:00
2. The next step is to go into the `NixFiles` directory this can be achieved by running `cd NixFiles`.
3. Now we you need to read over the configuration files and make any changes that you see fit, some of these must include changing your username and hostname.
2024-05-02 03:06:30 +00:00
4. You now must rebuild this configuration we can do this with `nix run darwin -- switch --flake .#hostname` hostname should be substituted for your systems hostname.
5. After your first run you are now able to use the `darwin-rebuild switch --flake .` command to rebuild your system.
2024-05-01 21:20:47 +00:00
2024-05-02 03:06:30 +00:00
#### With NixOS
2024-05-01 21:20:47 +00:00
1. Install a base NixOS system
2. Run `nix --extra-experimental-features nix-command --extra-experimental-features flakes flake new -t github:auxolotl/templates#system NixFiles`
3. Move into your new system with `cd NixFiles`
4. Fill in your `hostName` in `flake.nix`
5. Run `nixos-generate-config --show-hardware-config > host/hardware-configuration.nix` to generate configuration based on your filesystems and drivers
6. Edit the `host/configuration.nix` file with your desired system configuration
7. Run `nixos-rebuild build --flake .#hostName`, replacing hostName with your new hostName
2024-05-01 21:20:47 +00:00
Congratulations, you are now using NixOS!
2024-05-01 21:20:47 +00:00
#### With Home-manager
1. Run `nix --extra-experimental-features nix-command --extra-experimental-features flakes flake new -t github:auxolotl/templates#home-manager NixFiles` to start
2024-05-01 21:20:47 +00:00
2. Move into your new Nix system with `cd NixFiles`
2024-05-01 21:40:06 +00:00
3. Fill in your `username` in `flake.nix`