Skip to content

r17x/universe

Repository files navigation

Rin's Home 🏚

This "README" is available in 🇮🇩 Bahasa.

Motivation

(DRY) - Don't repeat yourself is a principle in software development. We should use this principle to reduce repetitive and time-consuming work. Personally, I just try to apply this principle in my professional and personal work. The most basic example is making these dotfiles, so that I don't have to provide the needs of the devices or tools used in everyday life. So, from this motivation you can see the main goal (Goal).

The work of a software developer, software engineer, or software laborer requires tools that are used on top of a running system (termed an operating system or OS). I am familiar with using operating systems such as OSX based on Darwin/Unix made by Apple and ArchLinux based on Linux. Well my goal is to become a human user agnostic (not religiously attached to a system but still loyal to the creator of the user, except for the operating system made by Mikocok). The tools are collected in one place to store everything about tools, configurations, settings, credentials, and others that support the needs of working or just operating a computer. Where is my container? In this github, then we need git or other tools, which is clear that we stay in sync between each machine we use so that we don't do repetitive things.

To keep it pure and the same between each machine, I decided to use Nix.

Nix

Nix is a "purely functional package manager", the Nix experience is completely different than other package managers. For some people it may seem complicated to use, but it is worth it if you understood what you really need.

If you have ever used the "virtual env" tool popular in the "python" ecosystem then you can experience the same thing but across operating systems, platforms, and programming language ecosystems.

Since nix uses functional concepts like declarative then it should be utilized well. such as declaring needs and then declaring with nix language.


Heavily inspired from (malob/nixpkgs) (especially in v1)

This is my personal configuration with nix using flakes, flake.part, home-manager, & nix-darwin for Darwin or MacOS System.

Structure

.
├── app/* (Applications, Packages, etc.)
├── nix/* (All nix related files)
├── nix/home (All home-manager related files)
├── nix/hosts (All hosts or machines related files)
├── nix/devShells.nix (All development shells - development environment)
├── nix/nix.nix (Nix CLI configuration)
├── nvim.nix/* (All nix related files for nvim - using [**Nixvim**](https://github.com/nix-community/nixvim))
├── notes/* (All notes with [**Neorg**](https://github.com/nvim-neorg/neorg) format)
├── flake.lock (Flake lock file)
├── flake.nix (Flake file for manage inputs)

Usage

Prerequisite

Nix

using Nix Flake

If you are not familiar with Nix, it is recommended to read this onboard by zero-to-nix to get started.

But if you want to use Nix, go jump to command below:

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
using Legacy Nix
Click to expand
System Single User Multiple User Command
Linux Single UserMulti User
Darwin (MacOS) Multi User
More...
Linux Single User
sh <(curl -L https://nixos.org/nix/install) --daemon
Linux Multi User
sh <(curl -L https://nixos.org/nix/install) --no-daemon
Darwin Multi User
sh <(curl -L https://nixos.org/nix/install)

Enable experimental-features

In general installation of nix, the nix configuration is located in ~/.config/nix/nix.conf. You MUST be set the experimental-features before use this configuration.

experimental-features = nix-command flakes

// (optional) for distribution cache (DON'T COPY THIS COMMENT LINE)
substituters = https://cache.nixos.org https://cache.nixos.org/ https://r17.cachix.org

Setup

After you have installed Nix, you can use the following command to clone this repository:

You can use the following nix options on this repository:

Using development environment

nix develop github:r17x/universe#<DEVELOPMENT_ENVIRONMENT_NAME>

Note

DEVELOPMENT_ENVIRONMENT_NAME is only available by devShells definitions nix build github:r17x/universe#darwinConfigurations.$HOSTNAME.system

with direnv
echo "use flake github:r17x/universe#<DEVELOPMENT_ENVIRONMENT_NAME>" > .envrc
direnv allow

# example:
echo "use flake github:r17x/universe#node20" > .envrc
direnv allow
> node -v
< v20.10.0

Activation nix-darwin for MacOS Environment

Build
# output `result` to `/tmp/result`
nix build github:r17x/universe#darwinConfigurations.$HOSTNAME.system -o /tmp/result

# example: nix build github:r17x/universe#darwinConfigurations.eR17x.system -o /tmp/result
Switch - Activate
# run `darwin-rebuild switch` to switch to latest build
# and wait until `darwin-rebuild` finish
/tmp/result/sw/bin/darwin-rebuild switch --flake github:r17x/universe#$HOSTNAME 

# example: /tmp/result/sw/bin/darwin-rebuild switch --flake github:r17x/universe#eR17x 

Note

$HOSTNAME is only available by hosts definitions

Alias Command List

  • drb - darwin rebuild aliases - rebuild this nixpkgs.
  • drs - darwin rebuild and switch the build version (make current build to current version of environment).
  • lenv - list of build version <VERSION>, that's usefull for switch aka rollback environment.
  • senv <VERSION> - switch spesific version (number).

Resources

Options

Acknowledgement