Update docs

This commit is contained in:
lelgenio 2023-05-18 08:25:02 -03:00
parent 9a67e3e098
commit b4a7e283ee
2 changed files with 40 additions and 26 deletions

View file

@ -2,9 +2,9 @@ Install dzgui on nix-based systems
# Installation # Installation
## Using flake profiles (manual updates) ## Using flake profiles (not recommended)
``` ```sh
# install # install
nix profile install github:lelgenio/dzgui-nix nix profile install github:lelgenio/dzgui-nix
@ -12,60 +12,74 @@ nix profile install github:lelgenio/dzgui-nix
nix profile upgrade '.*dzgui.*' nix profile upgrade '.*dzgui.*'
``` ```
## As a flake input (auto updates) ### You will also *need* to set `vm.max_map_count`:
Flake users are expected to have a `flake.nix` file and a `configuration.nix`. This is done automatically if you install via NixOs modules as shown
Note that this is just a suggestion on how to to it, you may have different configuration structure. #### on NixOs systems:
1 - Add `dzgui` as a flake input: ```nix
# configuration.nix
{
boot.kernel.sysctl."vm.max_map_count" = 1048576;
}
```
#### on non-NixOs systems:
```sh
sudo sysctl -w vm.max_map_count | sudo tee /etc/sysctl.d/dayz.conf
```
## As a NixOs module (recommended)
Flake users are assumed to have a `flake.nix` file and a `configuration.nix`.
1 - Add `dzgui-nix` as a flake input:
```nix ```nix
# flake.nix # flake.nix
{ {
inputs.dzgui = { inputs.dzgui-nix = {
# url of this repository, may change in the future # url of this repository, may change in the future
url = "github:lelgenio/dzgui-nix"; url = "github:lelgenio/dzgui-nix";
# save storage by not having duplicates of packages # save storage by not having duplicates of packages
inputs.nixpkgs.follows = "nixpkgs"; inputs.nixpkgs.follows = "nixpkgs";
}; };
# outputs... # other inputs...
} }
``` ```
2 - Pass `inputs` to your to you system config 2 - Add the `dzgui-nix` module to your system configuration, and enable it:
```nix ```nix
# flake.nix # flake.nix
{ {
outputs = inputs@{pkgs, ...}: { outputs = inputs@{pkgs, ...}: {
nixosConfigurations.your-hostname-here = lib.nixosSystem { nixosConfigurations.your-hostname-here = lib.nixosSystem {
specialArgs = { inherit inputs; }; modules = [
# modules... # Add the module
inputs.dzgui-nix.nixosModules.default
# Enable it, this can also go in configuration.nix
{ programs.dzgui.enable = true; }
# other modules...
];
}; };
}; };
} }
``` ```
3 - Add dzgui as a package in your system: 3 - Rebuild your system
```nix
# configuration.nix
# this is the file generate by `nixos-generate-config`
{ inputs, pkgs, ... }: {
environment.systemPackages = [
inputs.dzgui.packages.${pkgs.system}.dzgui
];
}
```
4 - Rebuild your system
```sh ```sh
nixos-rebuild --switch --flake .#your-hostname-here nixos-rebuild --switch --flake .#your-hostname-here
``` ```
Now dzgui will auto update together with your system. Now dzgui will update together with your flake:
```sh
nix flake update
```
## On non flake systems ## On non flake systems

View file

@ -30,7 +30,7 @@
nixosModules = rec { nixosModules = rec {
default = dzgui; default = dzgui;
dzgui = import ./module.nix {inherit self;}; dzgui = import ./module.nix { inherit self; };
}; };
devShells.${system}.default = devShells.${system}.default =