Merge branch 'userfix' into 'main'

Fix: Replace unreliable awk with sed for flake.nix username/profile updates

See merge request Zaney/zaneyos!137
This commit is contained in:
Don Williams 2025-11-30 08:44:36 -05:00
commit 58055efe6f
5 changed files with 425 additions and 214 deletions

View file

@ -5,10 +5,11 @@
---
# 🚀 **Current Release - ZaneyOS v2.5**
# 🚀 **Current Release - ZaneyOS v2.5.1**
#### 📅 **Updated: November 28th, 2025**
- FIXED: Username wasn't reliably being set in `flake.nix`
- Set ZaneyOS to NixOS v25.11 stable branch
- Moved to `nixvim` for NeoVIM configuration
- Works better
@ -35,28 +36,28 @@
- Moved screenshots into a markdown suummary to reduce clutter
- Added script to fix `doom iedit` update error
- Moved some modules/home/*.nix files to their own subdir
- Terminals
- Terminals
- Alacritty
- ghostty
- Kitty
- tmux
- Wezterm
- Editors
- Wezterm
- Editors
- antigravity
- emacs
- emacs
- evil-helix
- nixvim
- nvf
- vscode
- CLI/Utils
- nixvim
- nvf
- vscode
- CLI/Utils
- bat
- Btop
- Bottom
- cava
- fzf
- git
- gh
- lazygit
- Btop
- Bottom
- cava
- fzf
- git
- gh
- lazygit
#### 📅 **Updated: September 18th, 2025**

419
FAQ.es.md
View file

@ -1,8 +1,8 @@
[English](FAQ.md) | [Español](FAQ.es.md)
# 💬 Preguntas frecuentes de ZaneyOS para v2.4
# 💬 Preguntas frecuentes de ZaneyOS para v2.5.1
- **Fecha:** 28 de noviembre de 2025
- **Fecha:** 30 de noviembre de 2025
**⌨ ¿Dónde puedo ver los atajos de teclado de Hyprland?**
@ -13,48 +13,76 @@
<summary>**✨🖥️ ZCLI: ¿Qué es y cómo lo uso?**</summary>
<div style="margin-left: 20px;">
La utilidad `zcli` es una herramienta de línea de comandos diseñada para simplificar la gestión de tu entorno `zaneyos`. Proporciona un conjunto completo de comandos para realizar tareas comunes como actualizar tu sistema, gestionar hosts, limpiar generaciones antiguas y gestionar Doom Emacs.
La utilidad `zcli` es una herramienta de línea de comandos diseñada para
simplificar la gestión de tu entorno `zaneyos`. Proporciona un conjunto completo
de comandos para realizar tareas comunes como actualizar tu sistema, gestionar
hosts, limpiar generaciones antiguas y gestionar Doom Emacs.
Para usarlo, abre una terminal y escribe `zcli` seguido de uno de los comandos listados a continuación:
Para usarlo, abre una terminal y escribe `zcli` seguido de uno de los comandos
listados a continuación:
## Comandos del Sistema Core:
- `cleanup`: Limpia generaciones antiguas del sistema. Puedes especificar el número de generaciones a mantener. Incluye limpieza automatizada de logs de compilaciones antiguas.
- `diag`: Crea un reporte de diagnóstico completo del sistema usando `inxi --full`, guardado en `~/diag.txt`. Perfecto para solucionar problemas.
- `list-gens`: Lista tanto generaciones de usuario como de sistema con información detallada.
- `rebuild`: Recompila la configuración del sistema NixOS con verificaciones de seguridad mejoradas y manejo de archivos de respaldo.
- `rebuild-boot`: Recompila y establece como boot por defecto (se activa en el próximo reinicio). Más seguro para cambios importantes del sistema y actualizaciones del kernel.
- `trim`: Recorta sistemas de archivos para mejorar el rendimiento del SSD con prompts de confirmación del usuario.
- `update`: Actualiza el flake y recompila el sistema con manejo de errores completo.
- `update-host`: Establece automáticamente el host y perfil en `flake.nix`. Características detección inteligente de GPU y validación de hostname.
- `add-host`: Crea configuraciones de host nuevas con detección automática de GPU, generación de hardware.nix y integración con git.
- `del-host`: Elimina configuraciones de host de forma segura con prompts de confirmación para prevenir eliminación accidental.
- `cleanup`: Limpia generaciones antiguas del sistema. Puedes especificar el
número de generaciones a mantener. Incluye limpieza automatizada de logs de
compilaciones antiguas.
- `diag`: Crea un reporte de diagnóstico completo del sistema usando
`inxi --full`, guardado en `~/diag.txt`. Perfecto para solucionar problemas.
- `list-gens`: Lista tanto generaciones de usuario como de sistema con
información detallada.
- `rebuild`: Recompila la configuración del sistema NixOS con verificaciones de
seguridad mejoradas y manejo de archivos de respaldo.
- `rebuild-boot`: Recompila y establece como boot por defecto (se activa en el
próximo reinicio). Más seguro para cambios importantes del sistema y
actualizaciones del kernel.
- `trim`: Recorta sistemas de archivos para mejorar el rendimiento del SSD con
prompts de confirmación del usuario.
- `update`: Actualiza el flake y recompila el sistema con manejo de errores
completo.
- `update-host`: Establece automáticamente el host y perfil en `flake.nix`.
Características detección inteligente de GPU y validación de hostname.
- `add-host`: Crea configuraciones de host nuevas con detección automática de
GPU, generación de hardware.nix y integración con git.
- `del-host`: Elimina configuraciones de host de forma segura con prompts de
confirmación para prevenir eliminación accidental.
**Uso:** `zcli add-host [hostname] [profile]`
**Uso:** `zcli add-host [hostname] [profile]`\
**Perfiles de GPU:** `amd`, `intel`, `nvidia`, `nvidia-hybrid`, y `vm`
## Opciones Avanzadas de Compilación:
Los comandos `rebuild`, `rebuild-boot` y `update` soportan opciones mejoradas para control granular:
Los comandos `rebuild`, `rebuild-boot` y `update` soportan opciones mejoradas
para control granular:
- `--dry, -n`: Modo preview - muestra qué se haría sin ejecutar (dry run)
- `--ask, -a`: Prompts de confirmación interactiva para operaciones críticas de seguridad
- `--cores N`: Limita operaciones de compilación a N núcleos de CPU (esencial para VMs y sistemas con recursos limitados)
- `--verbose, -v`: Habilita logs detallados de operación y salida verbose para troubleshooting
- `--no-nom`: Deshabilita nix-output-monitor para salida tradicional de línea de comandos
- `--ask, -a`: Prompts de confirmación interactiva para operaciones críticas de
seguridad
- `--cores N`: Limita operaciones de compilación a N núcleos de CPU (esencial
para VMs y sistemas con recursos limitados)
- `--verbose, -v`: Habilita logs detallados de operación y salida verbose para
troubleshooting
- `--no-nom`: Deshabilita nix-output-monitor para salida tradicional de línea de
comandos
**Múltiples opciones pueden combinarse** para control preciso sobre tu proceso de compilación.
**Múltiples opciones pueden combinarse** para control preciso sobre tu proceso
de compilación.
## Gestión de Doom Emacs:
Gestión completa del ciclo de vida de Doom Emacs con características de seguridad:
Gestión completa del ciclo de vida de Doom Emacs con características de
seguridad:
- `doom install`: Instalación automatizada de Doom Emacs usando el script get-doom con todos los paquetes requeridos
- `doom status`: Verifica el estado de instalación y muestra información de versión para verificación
- `doom remove`: Remueve la instalación de Doom Emacs de forma segura con prompts de confirmación para prevenir eliminación accidental
- `doom update`: Actualiza paquetes de Doom Emacs y configuración vía `doom sync`
- `doom install`: Instalación automatizada de Doom Emacs usando el script
get-doom con todos los paquetes requeridos
- `doom status`: Verifica el estado de instalación y muestra información de
versión para verificación
- `doom remove`: Remueve la instalación de Doom Emacs de forma segura con
prompts de confirmación para prevenir eliminación accidental
- `doom update`: Actualiza paquetes de Doom Emacs y configuración vía
`doom sync`
**Características:** Verificaciones de seguridad integradas, manejo de errores completo y gestión automática de dependencias.
**Características:** Verificaciones de seguridad integradas, manejo de errores
completo y gestión automática de dependencias.
```text
❯ zcli
@ -113,13 +141,14 @@ zcli doom status # Verifica estado de instalación
## Atajos Principales de Hyprland
A continuación se muestran los atajos de teclado para Hyprland, formateados para fácil referencia.
A continuación se muestran los atajos de teclado para Hyprland, formateados para
fácil referencia.
## Lanzamiento de Aplicaciones
- `$modifier + Return` → Lanzar `Terminal`
- `$modifier + K` → Lista atajos
- `$modifier + D ` → Lanzar `launcher`
- `$modifier + D` → Lanzar `launcher`
- `$modifier + Shift + Return` → Lanzar `launcher`
- `$modifier + Shift + W` → Abrir `web-search`
- `$modifier + Alt + W` → Abrir `wallsetter`
@ -148,10 +177,14 @@ A continuación se muestran los atajos de teclado para Hyprland, formateados par
## Movimiento de Ventanas
- `$modifier + Shift + ← / → / ↑ / ↓` → Mover ventana izquierda/derecha/arriba/abajo
- `$modifier + Shift + H / L / K / J` → Mover ventana izquierda/derecha/arriba/abajo
- `$modifier + Alt + ← / → / ↑ / ↓` → Intercambiar ventana izquierda/derecha/arriba/abajo
- `$modifier + Alt + 43 / 46 / 45 / 44` → Intercambiar ventana izquierda/derecha/arriba/abajo
- `$modifier + Shift + ← / → / ↑ / ↓` → Mover ventana
izquierda/derecha/arriba/abajo
- `$modifier + Shift + H / L / K / J` → Mover ventana
izquierda/derecha/arriba/abajo
- `$modifier + Alt + ← / → / ↑ / ↓` → Intercambiar ventana
izquierda/derecha/arriba/abajo
- `$modifier + Alt + 43 / 46 / 45 / 44` → Intercambiar ventana
izquierda/derecha/arriba/abajo
## Movimiento de Foco
@ -186,11 +219,14 @@ A continuación se muestran los atajos de teclado para Hyprland, formateados par
- El nombre `ZaneyOS` es un chiste interno entre amigos.
- La intención es que esta configuración pueda usarse como daily driver
- Desarrollar software, jugar juegos vía steam, etc.
- Mi esperanza es que sea útil, y lo modifiques para que se ajuste a tus necesidades.
- Mi esperanza es que sea útil, y lo modifiques para que se ajuste a tus
necesidades.
- Ese es el punto clave. Hazlo tuyo.
- Crea un fork de ZaneyOS, luego modifícalo.
- Si encuentras un issue y lo arreglas, o proporcionas una nueva característica, por favor compártelo.
- ZaneyOS no es una distro. En este momento no hay planes para crear un ISO de instalación.
- Si encuentras un issue y lo arreglas, o proporcionas una nueva característica,
por favor compártelo.
- ZaneyOS no es una distro. En este momento no hay planes para crear un ISO de
instalación.
</div>
</details>
@ -273,7 +309,8 @@ A continuación se muestran los atajos de teclado para Hyprland, formateados par
- Remueve la línea con el paquete que quieres remover o coméntala
- Guarda el archivo y haz un rebuild con el alias `fr`
- Después puedes ejecutar `flatpak list` para verificar que los paquetes(s) estén removidos
- Después puedes ejecutar `flatpak list` para verificar que los paquetes(s)
estén removidos
- Nota: Las dependencias base para flatpaks permanecen una vez instaladas.
</details>
@ -310,9 +347,13 @@ waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix;
<details>
<summary>**¿Cómo cambio la configuración del monitor? **</summary>
La configuración del monitor está en el archivo: `~/zaneyos/hosts/<HOSTNAME>/variables.nix`
La configuración del monitor está en el archivo:
`~/zaneyos/hosts/<HOSTNAME>/variables.nix`
Dentro de las comillas la sintaxis es "monitor=adaptador de video,resolución@refresh rate, auto,escala" El monitor debe estar en minúsculas. Si no estás seguro de tus dispositivos de video ejecuta `hyprctl monitors` en una CLI de terminal. La salida se verá similar a esto:
Dentro de las comillas la sintaxis es "monitor=adaptador de
video,resolución@refresh rate, auto,escala" El monitor debe estar en minúsculas.
Si no estás seguro de tus dispositivos de video ejecuta `hyprctl monitors` en
una CLI de terminal. La salida se verá similar a esto:
```text
hyprctl monitors
@ -348,11 +389,17 @@ Edita la línea `extraMonitorSettings`. **Ejemplos:**
monitor=HDMI-A-1,2560x1440@75,auto,auto
";`
- Para configuraciones multi-monitor más complejas, puedes usar la aplicación GUI, `nwg-displays` Esta mostrará tus monitores conectados actualmente permitiéndote usar el mouse para coincidir cómo están arreglados físicamente. Ej. qué monitor está a la izquierda, derecha, arriba o abajo. Es muy similar a la herramienta X11 basada, `arandr` Creará entonces un archivo de configuración compatible con Hyprland en `~/.config/hypr/monitors.conf`
- Para configuraciones multi-monitor más complejas, puedes usar la aplicación
GUI, `nwg-displays` Esta mostrará tus monitores conectados actualmente
permitiéndote usar el mouse para coincidir cómo están arreglados físicamente.
Ej. qué monitor está a la izquierda, derecha, arriba o abajo. Es muy similar a
la herramienta X11 basada, `arandr` Creará entonces un archivo de
configuración compatible con Hyprland en `~/.config/hypr/monitors.conf`
<img align="center" width="90%" src="https://gitlab.com/Zaney/zaneyos/-/raw/main/img/nwg-displays.png" />
Después de configurar los monitores como deseas, presiona `Apply` para guardar los cambios en `~/.config/hypr/monitors.conf`\
Después de configurar los monitores como deseas, presiona `Apply` para guardar
los cambios en `~/.config/hypr/monitors.conf`\
El contenido se verá algo como esto:
```text
@ -361,11 +408,14 @@ monitor=HDMI-A-1,1920x1080@74.97,2136x268,1.0
monitor=eDP-1,1920x1080@144.0,216x268,1.0
```
Solo necesitas copiar las líneas `monitor=` y pegarlas en el archivo `variables.nix` como se describe en el proceso arriba.
Solo necesitas copiar las líneas `monitor=` y pegarlas en el archivo
`variables.nix` como se describe en el proceso arriba.
Una vez hecho eso. Ejecuta el comando alias `fr` para construir una nueva generación para hacer efectivos los cambios.
Una vez hecho eso. Ejecuta el comando alias `fr` para construir una nueva
generación para hacer efectivos los cambios.
Más información sobre configurar monitores está disponible en el [Wiki de Hyprland](https://wiki.hyprland.org/Configuring/Monitors/)
Más información sobre configurar monitores está disponible en el
[Wiki de Hyprland](https://wiki.hyprland.org/Configuring/Monitors/)
</details>
@ -374,13 +424,15 @@ Más información sobre configurar monitores está disponible en el [Wiki de Hyp
### Hay dos opciones. Una para todos los hosts que tienes, otra para un host específico.
1. Para aplicaciones que se incluirán en todos los hosts definidos edita el archivo `~/zaneyos/modules/core/packages.nix` file.
1. Para aplicaciones que se incluirán en todos los hosts definidos edita el
archivo `~/zaneyos/modules/core/packages.nix` file.
Hay una sección que comienza con: `environment.systemPackages = with pkgs;`
Seguida de una lista de paquetes. Estos son requeridos para ZaneyOS.
Te sugerimos agregar un comentario al final de los nombres de paquetes. Luego agrega tus paquetes.
Te sugerimos agregar un comentario al final de los nombres de paquetes. Luego
agrega tus paquetes.
```text
...
@ -427,7 +479,8 @@ La parte del archivo que necesitas editar se ve como esto:
}
```
Puedes agregar paquetes adicionales, o por ejemplo cambiar `discord` a `discord-canary` para obtener la versión beta de Discord pero solo en este host.
Puedes agregar paquetes adicionales, o por ejemplo cambiar `discord` a
`discord-canary` para obtener la versión beta de Discord pero solo en este host.
</details>
@ -438,7 +491,8 @@ Puedes agregar paquetes adicionales, o por ejemplo cambiar `discord` a `discord-
- Usa la utilidad `zcli`. `zcli rebuild`
- El alias legacy `fr`, Flake Rebuild está depreciado pero aún disponible
Si el rebuild se completa exitosamente, se creará una nueva generación con tus paquetes agregados.
Si el rebuild se completa exitosamente, se creará una nueva generación con tus
paquetes agregados.
</details>
@ -466,7 +520,8 @@ Si el rebuild se completa exitosamente, se creará una nueva generación con tus
<details>
<summary>** ¿Cómo puedo configurar un kernel diferente en un host específico? **</summary>
1. Tienes que editar el archivo `hardware.nix` para ese host en `~/zaneyos/hosts/HOSTNAME/hardware.nix` y override el default.
1. Tienes que editar el archivo `hardware.nix` para ese host en
`~/zaneyos/hosts/HOSTNAME/hardware.nix` y override el default.
2. Cerca del top encontrarás esta sección del archivo `hardware.nix`.
```nix
@ -490,7 +545,8 @@ boot.kernelModules = ["kvm-intel"];
boot.extraModulePackages = [];
```
5. Usa el comando `zcli rebuild` o alias `fr` para crear una nueva generación y reboot para que tome efecto.
5. Usa el comando `zcli rebuild` o alias `fr` para crear una nueva generación y
reboot para que tome efecto.
</details>
@ -501,28 +557,37 @@ NixOS ofrece varios tipos principales de kernel para adaptarse a diferentes nece
1. **`linuxPackages`**
- El kernel estable default, típicamente una versión LTS (Long-Term Support).
LTS en 25.05 (warbler) es 6.12.x Versiones más viejas, 6.6.x, 6.8.x no están soportadas.
LTS en 25.05 (warbler) es 6.12.x Versiones más viejas, 6.6.x, 6.8.x no
están soportadas.
2. **`linuxPackages_latest`**
- El kernel mainline más reciente, que puede incluir nuevas características pero podría ser menos estable.
- El kernel mainline más reciente, que puede incluir nuevas características
pero podría ser menos estable.
3. **`linuxPackages_zen`**
- Un kernel optimizado para rendimiento con parches dirigidos a mejorar la responsividad e interactividad. Comúnmente usado por gamers y usuarios de desktop.
- Un kernel optimizado para rendimiento con parches dirigidos a mejorar la
responsividad e interactividad. Comúnmente usado por gamers y usuarios de
desktop.
4. **`linuxPackages_hardened`**
- Un kernel enfocado en seguridad con parches adicionales de hardening para protección mejorada.
- Un kernel enfocado en seguridad con parches adicionales de hardening para
protección mejorada.
5. **`linuxPackages_rt`**
- Un kernel en tiempo real diseñado para baja latencia y aplicaciones sensibles al tiempo, como producción de audio o robótica.
- Un kernel en tiempo real diseñado para baja latencia y aplicaciones
sensibles al tiempo, como producción de audio o robótica.
6. **`linuxPackages_libre`**
- Un kernel stripped de firmware y drivers propietarios, adhiriéndose a principios de software libre.
- Un kernel stripped de firmware y drivers propietarios, adhiriéndose a
principios de software libre.
7. **`linuxPackages_xen_dom0`**
- Un kernel adaptado para correr como host (dom0) en entornos de virtualización Xen.
- Un kernel adaptado para correr como host (dom0) en entornos de
virtualización Xen.
8. **`linuxPackages_mptcp`**
- Un kernel con soporte para Multipath TCP, útil para escenarios avanzados de networking.
- Un kernel con soporte para Multipath TCP, útil para escenarios avanzados de
networking.
</details>
@ -530,7 +595,10 @@ NixOS ofrece varios tipos principales de kernel para adaptarse a diferentes nece
<summary>** Tengo generaciones viejas que quiero borrar, ¿cómo puedo hacerlo? **</summary>
- El alias NixOS Clean Generations `ncg` removerá **TODAS** menos la más actual generación. Asegúrate de haber booted desde esa generación antes de usar este alias. También hay un schedule que removerá generaciones viejas automáticamente con el tiempo.
- El alias NixOS Clean Generations `ncg` removerá **TODAS** menos la más actual
generación. Asegúrate de haber booted desde esa generación antes de usar este
alias. También hay un schedule que removerá generaciones viejas
automáticamente con el tiempo.
</details>
@ -538,9 +606,11 @@ NixOS ofrece varios tipos principales de kernel para adaptarse a diferentes nece
<summary>**¿Cómo cambio el hostname? **</summary>
Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el cambio efectivo.
Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el
cambio efectivo.
1. Copia el directorio del host que quieres renombrar a un directorio con el nuevo nombre.
1. Copia el directorio del host que quieres renombrar a un directorio con el
nuevo nombre.
- `cp -rpv ~/zaneyos/hosts/OLD-HOSTNAME ~/zaneyos/hosts/NEW-HOSTNAME`
@ -548,9 +618,11 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c
- `host = "NEW-HOSTNAME"`
3. En el directorio `~/zaneyos` ejecuta `git add .` _El rebuild fallará con un error 'file not found' si olvidas este paso._
3. En el directorio `~/zaneyos` ejecuta `git add .` _El rebuild fallará con un
error 'file not found' si olvidas este paso._
4. Usa el comando `zcli rebuild` o `fr` alias para crear una nueva generación con el nuevo hostname. Debes reboot para hacer el cambio efectivo.
4. Usa el comando `zcli rebuild` o `fr` alias para crear una nueva generación
con el nuevo hostname. Debes reboot para hacer el cambio efectivo.
</details>
<details>
@ -566,20 +638,30 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c
```
3. Cámbialo a `false`
4. Ejecuta el comando `zcli rebuild` o alias `fr` para crear una nueva generación.
4. Ejecuta el comando `zcli rebuild` o alias `fr` para crear una nueva
generación.
</details>
<details>
<summary>** ¿Cómo configuro mi laptop híbrida con GPUs Intel/NVIDIA? **</summary>
1. Ejecuta el script `install-zaneyos.sh` y selecciona el template `nvidia-laptop` o si configurando manualmente, establece el template en el `flake.nix` a `nvidia-prime`
1. Ejecuta el script `install-zaneyos.sh` y selecciona el template
`nvidia-laptop` o si configurando manualmente, establece el template en el
`flake.nix` a `nvidia-prime`
2. En el archivo `~/zaneyos/hosts/HYBRID-HOST/variables.nix` necesitarás establecer los PCI IDs para las GPUs Intel y NVIDIA. Refiérete a [esta página](https://nixos.wiki/wiki/Nvidia) para ayudar a determinar esos valores.
2. En el archivo `~/zaneyos/hosts/HYBRID-HOST/variables.nix` necesitarás
establecer los PCI IDs para las GPUs Intel y NVIDIA. Refiérete a
[esta página](https://nixos.wiki/wiki/Nvidia) para ayudar a determinar esos
valores.
3. Una vez que todo esté configurado apropiadamente, usa el alias Flake Rebuild `fr` para crear una nueva generación.
3. Una vez que todo esté configurado apropiadamente, usa el alias Flake Rebuild
`fr` para crear una nueva generación.
4. En el archivo `~/zaneyos/modules/home/hyprland/config.nix` hay un ENV setting`"AQ_DRM_DEVICES,/dev/dri/card0:/dev/dri/card1:/dev/dri/card2"` Esto establece la GPU primaria y secundaria. Usando la info del weblink arriba podrías tener que cambiar el orden de estos valores.
4. En el archivo `~/zaneyos/modules/home/hyprland/config.nix` hay un ENV
setting`"AQ_DRM_DEVICES,/dev/dri/card0:/dev/dri/card1:/dev/dri/card2"` Esto
establece la GPU primaria y secundaria. Usando la info del weblink arriba
podrías tener que cambiar el orden de estos valores.
</details>
@ -635,7 +717,8 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c
```
3. Selecciona la imagen que quieres que `stylix` use para la paleta de colores.
4. Ejecuta el comando `zcli rebuild` o `fr` alias para crear una nueva generación con este esquema de colores.
4. Ejecuta el comando `zcli rebuild` o `fr` alias para crear una nueva
generación con este esquema de colores.
- Para deshabilitar descomenta
@ -643,27 +726,28 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c
2. Descomenta desde `base16Scheme` hasta el `};` después de `base0F`
```nix
base16Scheme = {
base00 = "282936";
base01 = "3a3c4e";
base02 = "4d4f68";
base03 = "626483";
base04 = "62d6e8";
base05 = "e9e9f4";
base06 = "f1f2f8";
base07 = "f7f7fb";
base08 = "ea51b2";
base09 = "b45bcf";
base0A = "00f769";
base0B = "ebff87";
base0C = "a1efe4";
base0D = "62d6e8";
base0E = "b45bcf";
base0F = "00f769";
};
base16Scheme = {
base00 = "282936";
base01 = "3a3c4e";
base02 = "4d4f68";
base03 = "626483";
base04 = "62d6e8";
base05 = "e9e9f4";
base06 = "f1f2f8";
base07 = "f7f7fb";
base08 = "ea51b2";
base09 = "b45bcf";
base0A = "00f769";
base0B = "ebff87";
base0C = "a1efe4";
base0D = "62d6e8";
base0E = "b45bcf";
base0F = "00f769";
};
```
3. Ejecuta el comando `zcli rebuild` o `fr` alias para construir una nueva generación con el dracula default o establece tus propios colores custom
3. Ejecuta el comando `zcli rebuild` o `fr` alias para construir una nueva
generación con el dracula default o establece tus propios colores custom
</details>
@ -671,7 +755,8 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c
<summary>¿Cómo cambio la imagen que Stylix usa para tematizar?</summary>
1. Edita el archivo `~/zaneyos/hosts/HOSTNAME/varibles.nix`
2. Cambia el `stylixImage =` al nombre del archivo que quieres usar. Los wallpapers están en `~/zaneyos/wallpapers`
2. Cambia el `stylixImage =` al nombre del archivo que quieres usar. Los
wallpapers están en `~/zaneyos/wallpapers`
```nix
# Establecer Imagen Stylix
@ -731,7 +816,8 @@ settings = {
];
```
4. Ejecuta el comando `zcli rebuild` o alias `fr` para crear una nueva generación.
4. Ejecuta el comando `zcli rebuild` o alias `fr` para crear una nueva
generación.
5. Necesitarás logout o reboot para que el cambio sea efectivo.
</details>
@ -742,7 +828,8 @@ settings = {
1. Edita el archivo `~/zaneyos/modules/home/scripts/wallsetter`
2. Cambia el valor `TIMEOUT =` . Está en segundos.
3. Ejecuta el comando `zcli rebuild` o alias `fr`, para crear una nueva generación.
3. Ejecuta el comando `zcli rebuild` o alias `fr`, para crear una nueva
generación.
4. Necesitarás logout o reboot para que el cambio sea efectivo.
</details>
@ -759,9 +846,12 @@ settings = {
<details>
<summary> Para versión v2.3 </summary>
Altamente recomendado: Lee `ZaneyOS-Upgrade.md` antes de proceder. Detalla el upgrade automatizado seguro, respaldo, y proceso de revert.
Altamente recomendado: Lee `ZaneyOS-Upgrade.md` antes de proceder. Detalla el
upgrade automatizado seguro, respaldo, y proceso de revert.
Usa el upgrade automatizado v2.3 → v2.4. Ve `ZaneyOS-Upgrade.md` y `UPGRADE-2.3-to-2.4.md`. Para evitar sobrescribir tu config antes de crear un respaldo, fetch solo el script sin modificar tu working tree:
Usa el upgrade automatizado v2.3 → v2.4. Ve `ZaneyOS-Upgrade.md` y
`UPGRADE-2.3-to-2.4.md`. Para evitar sobrescribir tu config antes de crear un
respaldo, fetch solo el script sin modificar tu working tree:
- Git (recomendado):
@ -778,12 +868,15 @@ curl -fsSL https://gitlab.com/zaney/zaneyos/-/raw/main/upgrade-2.3-to-2.4.sh -o
chmod +x ~/upgrade-2.3-to-2.4.sh
```
Luego ejecuta el script: `~/upgrade-2.3-to-2.4.sh`. Creará un respaldo completo antes de cambiar branches y migrará tus hosts de forma segura desde el respaldo.
Luego ejecuta el script: `~/upgrade-2.3-to-2.4.sh`. Creará un respaldo completo
antes de cambiar branches y migrará tus hosts de forma segura desde el respaldo.
**IMPORTANTE:**
- NO uses los alias `fu` o `fr` para este upgrade; el script usa un boot build seguro.
- Si has hecho modificaciones extensas, no ejecutes el script. Lee los docs arriba y migra manualmente en su lugar.
- NO uses los alias `fu` o `fr` para este upgrade; el script usa un boot build
seguro.
- Si has hecho modificaciones extensas, no ejecutes el script. Lee los docs
arriba y migra manualmente en su lugar.
</details>
@ -793,29 +886,35 @@ Luego ejecuta el script: `~/upgrade-2.3-to-2.4.sh`. Creará un respaldo completo
1. Primero respaldo tu directorio `zaneyos` existente. ej.
`cp -r ~/zaneyos ~/zaneyos-backup`
2. No hay update directo. Cuando clones la nueva config los archivos de config y layout han cambiado.
2. No hay update directo. Cuando clones la nueva config los archivos de config y
layout han cambiado.
3. Necesitas instalar zaneyos como una nueva install. `./install-zaneyos.sh`
4. Una vez que el build se complete y hayas rebooted puedes revisar el nuevo layout y decidir si algún cambio que hiciste en la versión anterior puede ser migrado a v2.3.
4. Una vez que el build se complete y hayas rebooted puedes revisar el nuevo
layout y decidir si algún cambio que hiciste en la versión anterior puede ser
migrado a v2.3.
</details>
<details>
<summary> Para versión v1.x </summary>
1. El layout y configuración son completamente diferentes. Virtualmente nada de 1.x es aplicable a v2.3.
1. El layout y configuración son completamente diferentes. Virtualmente nada de
1.x es aplicable a v2.3.
2. Respalda tu directorio `zaneyos` ej. `cp -r ~/zaneyos ~/zaneyos-backup`
3. Ejecuta el script `./install-zaneyos.sh` y sigue las nuevas instrucciones de install.
3. Ejecuta el script `./install-zaneyos.sh` y sigue las nuevas instrucciones de
install.
</details>
<details>
<summary> ¿Cómo sé cuándo se lanza una nueva versión de ZaneyOS? </summary>
Será anunciado en el servidor Discord de Zaney [Discord](https://discord.gg/W7efsSDS).
Será anunciado en el servidor Discord de Zaney
[Discord](https://discord.gg/W7efsSDS).
</details>
@ -882,8 +981,10 @@ Será anunciado en el servidor Discord de Zaney [Discord](https://discord.gg/W7e
**Update**
<br>
- Usando el comando `zcli rebuild` o `zcli upgrade` buscará este archivo causando fallos de rebuild
- Si encuentras otros archivos que causan esto puedes agregarlos en el `zaneyos/modules/home/scripts/default.nix`
- Usando el comando `zcli rebuild` o `zcli upgrade` buscará este archivo
causando fallos de rebuild
- Si encuentras otros archivos que causan esto puedes agregarlos en el
`zaneyos/modules/home/scripts/default.nix`
<br>
```text
@ -903,7 +1004,8 @@ May 08 18:33:57 explorer systemd[1]: Failed to start Home Manager environment fo
- Te promptará para borrar estos backups
- También crea un log
- Nota: El script no es perfecto
- Si obtienes este msg pero `hm-find` no reporta ninguno tendrás que buscar manualmente ej `journalctl | grep hm-activate`
- Si obtienes este msg pero `hm-find` no reporta ninguno tendrás que buscar
manualmente ej `journalctl | grep hm-activate`
- Puedes entonces redo tu rebuild
- Usa el comando `zcli rebuild` o `fr` para `flake rebuild`
- El flake ya ha sido actualizado
@ -921,16 +1023,22 @@ May 08 18:33:57 explorer systemd[1]: Failed to start Home Manager environment fo
**1. Layout Master**
- El layout **Master** divide el workspace en dos áreas principales:
- Un **área master** para la ventana primaria, que toma una porción más grande de la pantalla.
- Un **área stack** para todas las otras ventanas, que están tiled en el espacio restante.
- Este layout es ideal para workflows donde quieres enfocarte en una ventana main mientras mantienes otras accesibles.
- Un **área master** para la ventana primaria, que toma una porción más grande
de la pantalla.
- Un **área stack** para todas las otras ventanas, que están tiled en el
espacio restante.
- Este layout es ideal para workflows donde quieres enfocarte en una ventana
main mientras mantienes otras accesibles.
**2. Layout Dwindle**
- El layout **Dwindle** es un layout de tiling basado en árbol binario:
- Cada nueva ventana split el espacio disponible dinámicamente, alternando entre splits horizontales y verticales.
- Los splits son determinados por el aspect ratio del contenedor padre (ej. splits más anchos horizontalmente, más altos verticalmente).
- Este layout es más dinámico y distribuye espacio equitativamente entre todas las ventanas.
- Cada nueva ventana split el espacio disponible dinámicamente, alternando
entre splits horizontales y verticales.
- Los splits son determinados por el aspect ratio del contenedor padre (ej.
splits más anchos horizontalmente, más altos verticalmente).
- Este layout es más dinámico y distribuye espacio equitativamente entre todas
las ventanas.
---
@ -950,7 +1058,8 @@ Para verificar cuál layout está activo actualmente, usa el comando `hyprctl`:
<div style="margin-left: 20px;"> <br>
El archivo de configuración de Yazi está localizado en `~/zaneyos/modules/home/yazi.nix`
El archivo de configuración de Yazi está localizado en
`~/zaneyos/modules/home/yazi.nix`
Yazi está configurado como VIM y motions VIM
@ -1076,10 +1185,13 @@ El keymap está en el archivo `~/zaneyos/modules/home/yazi/keymap.toml` file
<summary>Mi cursor en Kitty es "janky" y salta alrededor. ¿Cómo lo arreglo?</summary>
- Esa característica se llama "cursor_trail" en el archivo `~/zaneyos/modules/home/kitty.nix`.
- Esa característica se llama "cursor_trail" en el archivo
`~/zaneyos/modules/home/kitty.nix`.
1. Edita ese archivo y cambia el `cursor_trail 1` a `cursor_trail 0` o comenta esa línea.
2. Usa el alias `zcli rebuild` o `fr` para crear una nueva generación con el cambio.
1. Edita ese archivo y cambia el `cursor_trail 1` a `cursor_trail 0` o comenta
esa línea.
2. Usa el alias `zcli rebuild` o `fr` para crear una nueva generación con el
cambio.
</details>
@ -1156,7 +1268,8 @@ Los defaults son:
<summary>¿Cómo habilito WezTerm?</summary>
Edita el `/zaneyos/modules/home/wezterm.nix` Cambia `enable = false` a `enable = true;`\
Edita el `/zaneyos/modules/home/wezterm.nix` Cambia `enable = false` a
`enable = true;`\
Guarda el archivo y rebuild zaneyos con el comando `zcli rebild` o el alias `fr`
```
@ -1226,7 +1339,8 @@ theme = Dracula
#theme = GruvboxDarkHard
```
3. Comenta `Dracula` y descomenta uno de los otros o agrega uno de los muchos temas de ghostty.
3. Comenta `Dracula` y descomenta uno de los otros o agrega uno de los muchos
temas de ghostty.
</details>
@ -1276,29 +1390,34 @@ theme = Dracula
</div>
</details>
**
--> 🪧 Temas relacionados con NixOS general
**
** --> 🪧 Temas relacionados con NixOS general **
<details>
<summary>**❄ ¿Qué son los Flakes en NixOS? **</summary>
<div style="margin-left: 20px;">
**Flakes** son una característica del package manager Nix que simplifica y estandariza cómo se gestionan configuraciones, dependencias y paquetes. Si estás familiarizado con herramientas como `package.json` en JavaScript o `Cargo.toml` en Rust, flakes sirven un propósito similar en el ecosistema Nix.
**Flakes** son una característica del package manager Nix que simplifica y
estandariza cómo se gestionan configuraciones, dependencias y paquetes. Si estás
familiarizado con herramientas como `package.json` en JavaScript o `Cargo.toml`
en Rust, flakes sirven un propósito similar en el ecosistema Nix.
** Características Clave de Flakes: **
1. **Pin Dependencias**:
- Flakes lock las versiones de dependencias en un archivo `flake.lock`, asegurando reproducibilidad entre sistemas.
- Flakes lock las versiones de dependencias en un archivo `flake.lock`,
asegurando reproducibilidad entre sistemas.
2. **Estandarizar Configuraciones**:
- Usan un archivo `flake.nix` para definir cómo build, run o deploy un proyecto o sistema, haciendo setups más predecibles.
- Usan un archivo `flake.nix` para definir cómo build, run o deploy un
proyecto o sistema, haciendo setups más predecibles.
3. **Mejorar Usabilidad**:
- Flakes simplifican compartir y reusar configuraciones entre diferentes sistemas o proyectos proporcionando una estructura consistente.
- Flakes simplifican compartir y reusar configuraciones entre diferentes
sistemas o proyectos proporcionando una estructura consistente.
En esencia, flakes ayudan a gestionar setups de NixOS o proyectos basados en Nix de una manera más portable y confiable.
En esencia, flakes ayudan a gestionar setups de NixOS o proyectos basados en Nix
de una manera más portable y confiable.
</div>
@ -1307,50 +1426,75 @@ En esencia, flakes ayudan a gestionar setups de NixOS o proyectos basados en Nix
<details>
<summary>**🏡 ¿Qué es NixOS Home Manager? **</summary>
**Home Manager** es una herramienta poderosa en el ecosistema Nix que te permite gestionar configuraciones y entornos específicos de usuario de manera declarativa. Con Home Manager, puedes simplificar el setup de dotfiles, settings de shell, aplicaciones y paquetes de sistema para tu perfil de usuario.
**Home Manager** es una herramienta poderosa en el ecosistema Nix que te permite
gestionar configuraciones y entornos específicos de usuario de manera
declarativa. Con Home Manager, puedes simplificar el setup de dotfiles, settings
de shell, aplicaciones y paquetes de sistema para tu perfil de usuario.
### Características Clave de Home Manager:
1. **Configuración Declarativa**:
- Define todos tus settings y preferencias en un solo archivo `home.nix`, haciendo fácil trackear, compartir y replicar tu setup.
- Define todos tus settings y preferencias en un solo archivo `home.nix`,
haciendo fácil trackear, compartir y replicar tu setup.
2. **Soporte Cross-Distribution**:
- Home Manager funciona no solo en NixOS sino también en otras distribuciones Linux y macOS, permitiéndote estandarizar configuraciones entre dispositivos.
- Home Manager funciona no solo en NixOS sino también en otras distribuciones
Linux y macOS, permitiéndote estandarizar configuraciones entre
dispositivos.
3. **Gestión de Entorno de Usuario**:
- Gestiona aplicaciones, variables de entorno, configuraciones de shell y más—todo aislado a tu perfil de usuario.
- Gestiona aplicaciones, variables de entorno, configuraciones de shell y
más—todo aislado a tu perfil de usuario.
### ¿Por Qué Usar Home Manager?
Home Manager simplifica la gestión de sistema ofreciendo consistencia, reproducibilidad y portabilidad. Ya sea que estés customizando tu entorno de desarrollo o compartiendo configuraciones entre máquinas, proporciona una manera eficiente de adaptar tu experiencia de usuario.
Home Manager simplifica la gestión de sistema ofreciendo consistencia,
reproducibilidad y portabilidad. Ya sea que estés customizando tu entorno de
desarrollo o compartiendo configuraciones entre máquinas, proporciona una manera
eficiente de adaptar tu experiencia de usuario.
</details>
<details>
<summary>**🏭 ¿Qué son los Builds Atómicos?**</summary>
**Builds atómicos** en NixOS aseguran que cualquier cambio de sistema (como instalar software o actualizar la configuración) se aplique de manera segura y fail-proof. Esto significa que una actualización de sistema es completamente exitosa o no tiene efecto alguno, eliminando el riesgo de un estado de sistema parcialmente aplicado o roto.
**Builds atómicos** en NixOS aseguran que cualquier cambio de sistema (como
instalar software o actualizar la configuración) se aplique de manera segura y
fail-proof. Esto significa que una actualización de sistema es completamente
exitosa o no tiene efecto alguno, eliminando el riesgo de un estado de sistema
parcialmente aplicado o roto.
### Cómo Funcionan los Builds Atómicos:
1. **Generación de Sistema Inmutable**:
- Cada cambio de configuración crea una nueva "generación" del sistema, mientras las previas permanecen intactas. Puedes fácilmente rollback a una generación anterior si algo sale mal.
- Cada cambio de configuración crea una nueva "generación" del sistema,
mientras las previas permanecen intactas. Puedes fácilmente rollback a una
generación anterior si algo sale mal.
2. **Comportamiento Transaccional**:
- Similar a transacciones de database, los cambios se aplican atómicamente: o tienen éxito y se convierten en el nuevo sistema activo, o fallan y dejan el sistema actual sin cambios.
- Similar a transacciones de database, los cambios se aplican atómicamente: o
tienen éxito y se convierten en el nuevo sistema activo, o fallan y dejan
el sistema actual sin cambios.
3. **Rollbacks Sin Problemas**:
- En caso de errores o issues, puedes reboot y seleccionar una generación previa de sistema desde el menú de boot para retornar a un estado funcional.
- En caso de errores o issues, puedes reboot y seleccionar una generación
previa de sistema desde el menú de boot para retornar a un estado
funcional.
### Beneficios de Builds Atómicos:
- **Confiabilidad**: Tu sistema está siempre en un estado consistente, incluso si un cambio de configuración falla.
- **Reproducibilidad**: La misma configuración siempre producirá el mismo estado de sistema, haciendo fácil debuggear o replicar.
- **Facilidad de Rollback**: Revertir a una configuración funcional es tan simple como reboot y seleccionar la generación previa.
- **Confiabilidad**: Tu sistema está siempre en un estado consistente, incluso
si un cambio de configuración falla.
- **Reproducibilidad**: La misma configuración siempre producirá el mismo estado
de sistema, haciendo fácil debuggear o replicar.
- **Facilidad de Rollback**: Revertir a una configuración funcional es tan
simple como reboot y seleccionar la generación previa.
### ¿Por Qué NixOS Usa Builds Atómicos?
Esta característica es un cornerstone de la filosofía de diseño declarativo y reproducible de NixOS, asegurando que la gestión de sistema sea predecible y sin estrés.
Esta característica es un cornerstone de la filosofía de diseño declarativo y
reproducible de NixOS, asegurando que la gestión de sistema sea predecible y sin
estrés.
</details>
@ -1378,4 +1522,3 @@ Esta característica es un cornerstone de la filosofía de diseño declarativo y
</div>
</details>

105
FAQ.md
View file

@ -1,8 +1,8 @@
[English](FAQ.md) | [Español](FAQ.es.md)
# 💬 ZaneyOS FAQ for v2.5
# 💬 ZaneyOS FAQ for v2.5.1
- **Date:** 28-November-2025
- **Date:** 30-November-2025
**⌨ Where can I see the Hyprland keybindings?**
@ -14,54 +14,72 @@
<div style="margin-left: 20px;">
The `zcli` utility is a command-line tool designed to simplify the management of
your `zaneyos` environment. It provides a comprehensive set of commands to perform common
tasks such as updating your system, managing hosts, cleaning up old generations,
and managing Doom Emacs.
your `zaneyos` environment. It provides a comprehensive set of commands to
perform common tasks such as updating your system, managing hosts, cleaning up
old generations, and managing Doom Emacs.
To use it, open a terminal and type `zcli` followed by one of the commands
listed below:
## Core System Commands:
- `cleanup`: Clean up old system generations. You can specify the number of generations to keep. Includes automated log cleanup for old build logs.
- `diag`: Create a comprehensive system diagnostic report using `inxi --full`, saved to `~/diag.txt`. Perfect for troubleshooting.
- `cleanup`: Clean up old system generations. You can specify the number of
generations to keep. Includes automated log cleanup for old build logs.
- `diag`: Create a comprehensive system diagnostic report using `inxi --full`,
saved to `~/diag.txt`. Perfect for troubleshooting.
- `list-gens`: List both user and system generations with detailed information.
- `rebuild`: Rebuild the NixOS system configuration with enhanced safety checks and backup file handling.
- `rebuild-boot`: Rebuild and set as boot default (activates on next restart). Safer for major system changes and kernel updates.
- `trim`: Trim filesystems to improve SSD performance with user confirmation prompts.
- `update`: Update the flake and rebuild the system with comprehensive error handling.
- `rebuild`: Rebuild the NixOS system configuration with enhanced safety checks
and backup file handling.
- `rebuild-boot`: Rebuild and set as boot default (activates on next restart).
Safer for major system changes and kernel updates.
- `trim`: Trim filesystems to improve SSD performance with user confirmation
prompts.
- `update`: Update the flake and rebuild the system with comprehensive error
handling.
## Host Management:
- `update-host`: Automatically set the host and profile in `flake.nix`. Features intelligent GPU detection and hostname validation.
- `add-host`: Create new host configurations with automated GPU detection, hardware.nix generation, and git integration.
- `del-host`: Safely delete host configurations with confirmation prompts to prevent accidental removal.
- `update-host`: Automatically set the host and profile in `flake.nix`. Features
intelligent GPU detection and hostname validation.
- `add-host`: Create new host configurations with automated GPU detection,
hardware.nix generation, and git integration.
- `del-host`: Safely delete host configurations with confirmation prompts to
prevent accidental removal.
**Usage:** `zcli add-host [hostname] [profile]`
**Usage:** `zcli add-host [hostname] [profile]`\
**GPU Profiles:** `amd`, `intel`, `nvidia`, `nvidia-hybrid`, and `vm`
## Advanced Build Options:
The `rebuild`, `rebuild-boot`, and `update` commands support enhanced options for fine-grained control:
The `rebuild`, `rebuild-boot`, and `update` commands support enhanced options
for fine-grained control:
- `--dry, -n`: Preview mode - shows what would be done without executing (dry run)
- `--dry, -n`: Preview mode - shows what would be done without executing (dry
run)
- `--ask, -a`: Interactive confirmation prompts for safety-critical operations
- `--cores N`: Limit build operations to N CPU cores (essential for VMs and resource-constrained systems)
- `--verbose, -v`: Enable detailed operation logs and verbose output for troubleshooting
- `--cores N`: Limit build operations to N CPU cores (essential for VMs and
resource-constrained systems)
- `--verbose, -v`: Enable detailed operation logs and verbose output for
troubleshooting
- `--no-nom`: Disable nix-output-monitor for traditional command-line output
**Multiple options can be combined** for precise control over your build process.
**Multiple options can be combined** for precise control over your build
process.
## Doom Emacs Management:
Complete Doom Emacs lifecycle management with safety features:
- `doom install`: Automated Doom Emacs installation using the get-doom script with all required packages
- `doom status`: Check installation status and display version information for verification
- `doom remove`: Safely remove Doom Emacs installation with confirmation prompts to prevent accidental deletion
- `doom install`: Automated Doom Emacs installation using the get-doom script
with all required packages
- `doom status`: Check installation status and display version information for
verification
- `doom remove`: Safely remove Doom Emacs installation with confirmation prompts
to prevent accidental deletion
- `doom update`: Update Doom Emacs packages and configuration via `doom sync`
**Features:** Built-in safety checks, comprehensive error handling, and automatic dependency management.
**Features:** Built-in safety checks, comprehensive error handling, and
automatic dependency management.
```text
❯ zcli
@ -126,7 +144,7 @@ Below are the keybindings for Hyprland, formatted for easy reference.
- `$modifier + Return` → Launch `Terminal`
- `$modifier + K` → List keybinds
- `$modifier + D ` → Application Launcher
- `$modifier + D` → Application Launcher
- `$modifier + Shift + Return` → Application Launcher
- `$modifier + Shift + W` → Open `web-search`
- `$modifier + Alt + W` → Open `wallsetter`
@ -812,9 +830,12 @@ settings = {
<details>
<summary> For version v2.3 </summary>
Strongly recommended: Read `ZaneyOS-Upgrade.md` before proceeding. It details the safe, automated upgrade, backup, and revert process.
Strongly recommended: Read `ZaneyOS-Upgrade.md` before proceeding. It details
the safe, automated upgrade, backup, and revert process.
Use the automated v2.3 → v2.4 upgrade. See `ZaneyOS-Upgrade.md` and `UPGRADE-2.3-to-2.4.md`. To avoid overwriting your config before a backup is created, fetch just the script without modifying your working tree:
Use the automated v2.3 → v2.4 upgrade. See `ZaneyOS-Upgrade.md` and
`UPGRADE-2.3-to-2.4.md`. To avoid overwriting your config before a backup is
created, fetch just the script without modifying your working tree:
- Git (recommended):
@ -831,12 +852,15 @@ curl -fsSL https://gitlab.com/zaney/zaneyos/-/raw/main/upgrade-2.3-to-2.4.sh -o
chmod +x ~/upgrade-2.3-to-2.4.sh
```
Then run the script: `~/upgrade-2.3-to-2.4.sh`. It will create a full backup before switching branches and migrate your hosts safely from the backup.
Then run the script: `~/upgrade-2.3-to-2.4.sh`. It will create a full backup
before switching branches and migrate your hosts safely from the backup.
**IMPORTANT:**
- Do NOT use the `fu` or `fr` aliases for this upgrade; the script uses a safe boot build.
- If you have made extensive modifications, do not run the script. Read the docs above and migrate manually instead.
- Do NOT use the `fu` or `fr` aliases for this upgrade; the script uses a safe
boot build.
- If you have made extensive modifications, do not run the script. Read the docs
above and migrate manually instead.
</details>
@ -1349,9 +1373,7 @@ theme = Dracula
</div>
</details>
**
--> 🪧 General NixOS related topics
**
** --> 🪧 General NixOS related topics **
<details>
<summary>**❄ What are Flakes in NixOS? **</summary>
@ -1999,7 +2021,9 @@ settings = {
<details>
<summary> For version v2.3 </summary>
Use the automated v2.3 → v2.4 upgrade. See ZaneyOS-Upgrade.md and UPGRADE-2.3-to-2.4.md. To avoid overwriting your config before a backup is created, fetch just the script without modifying your working tree:
Use the automated v2.3 → v2.4 upgrade. See ZaneyOS-Upgrade.md and
UPGRADE-2.3-to-2.4.md. To avoid overwriting your config before a backup is
created, fetch just the script without modifying your working tree:
- Git (recommended):
@ -2016,12 +2040,15 @@ curl -fsSL https://gitlab.com/zaney/zaneyos/-/raw/main/upgrade-2.3-to-2.4.sh -o
chmod +x ~/upgrade-2.3-to-2.4.sh
```
Then run the script: `~/upgrade-2.3-to-2.4.sh`. It will create a full backup before switching branches and migrate your hosts safely from the backup.
Then run the script: `~/upgrade-2.3-to-2.4.sh`. It will create a full backup
before switching branches and migrate your hosts safely from the backup.
**IMPORTANT:**
- Do NOT use the `fu` or `fr` aliases for this upgrade; the script uses a safe boot build.
- If you have made extensive modifications, do not run the script. Read the docs above and migrate manually instead.
- Do NOT use the `fu` or `fr` aliases for this upgrade; the script uses a safe
boot build.
- If you have made extensive modifications, do not run the script. Read the docs
above and migrate manually instead.
</details>
@ -2529,9 +2556,7 @@ theme = Dracula
</div>
</details>
**
--> 🪧 General NixOS related topics
**
** --> 🪧 General NixOS related topics **
<details>
<summary>**❄ What are Flakes in NixOS? **</summary>

View file

@ -9,6 +9,9 @@
# Define colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
NC='\033[0m' # No Color
# Define log file
@ -25,6 +28,19 @@ print_header() {
echo -e "${GREEN}╚═══════════════════════════════════════════════════════════════════════╝${NC}"
}
# Function to print a configuration summary
print_summary() {
echo -e "${CYAN}╔═══════════════════════════════════════════════════════════════════════╗${NC}"
echo -e "${CYAN}║ 📋 Installation Configuration Summary ║${NC}"
echo -e "${CYAN}╠═══════════════════════════════════════════════════════════════════════╣${NC}"
echo -e "${CYAN}║ 🖥️ Hostname: ${BLUE}${1}${NC}"
echo -e "${CYAN}║ 🎮 GPU Profile: ${BLUE}${2}${NC}"
echo -e "${CYAN}║ 👤 System Username: ${BLUE}${3}${NC}"
echo -e "${CYAN}║ 🌐 Timezone: ${BLUE}${4}${NC}"
echo -e "${CYAN}║ ⌨️ Keyboard Layout: ${BLUE}${5}${NC}"
echo -e "${CYAN}╚═══════════════════════════════════════════════════════════════════════╝${NC}"
}
# Function to print an error message
print_error() {
echo -e "${RED}Error: ${1}${NC}"
@ -216,7 +232,7 @@ else
fi
print_header "Cloning ZaneyOS Repository"
git clone https://gitlab.com/zaney/zaneyos.git -b stable-2.5.0 --depth=1 ~/zaneyos
git clone https://gitlab.com/zaney/zaneyos.git -b stable-2.5.1 --depth=1 ~/zaneyos
cd ~/zaneyos || exit 1
print_header "Git Configuration"
@ -287,22 +303,43 @@ print_header "Configuring Host and Profile"
mkdir -p hosts/"$hostName"
cp hosts/default/*.nix hosts/"$hostName"
git config --global user.name "$gitUsername"
git config --global user.email "$gitEmail"
git add .
git config --global --unset-all user.name
git config --global --unset-all user.email
# Show a nice summary and ask for confirmation before making changes
echo ""
print_summary "$hostName" "$profile" "$installusername" "$timezone" "$keyboardLayout"
echo ""
echo -e "${YELLOW}Please review the configuration above.${NC}"
read -p "$(echo -e "${YELLOW}Continue with installation? (Y/N): ${NC}")" -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
echo -e "${RED}Installation cancelled.${NC}"
exit 1
fi
echo "Updating configuration files with working awk commands..."
echo ""
echo -e "${GREEN}✓ Configuration accepted. Starting installation...${NC}"
echo ""
echo -e "${BLUE}Updating configuration files...${NC}"
echo -e " ${CYAN}installusername:${NC} $installusername"
echo -e " ${CYAN}hostName:${NC} $hostName"
echo -e " ${CYAN}profile:${NC} $profile"
echo -e " ${CYAN}timezone:${NC} $timezone"
echo -e " ${CYAN}keyboardLayout:${NC} $keyboardLayout"
echo " installusername: $installusername"
echo " hostName: $hostName"
echo " profile: $profile"
# Update flake.nix (simple pattern replacements that work)
# Create backup first, before any changes
cp ./flake.nix ./flake.nix.bak
# Use sed for hostname (more reliable)
sed -i "/^[[:space:]]*host[[:space:]]*=[[:space:]]*\"/s/\"[^\"]*\"/\"$hostName\"/" ./flake.nix.bak
awk -v newprof="$profile" '/^ profile = / { gsub(/"[^"]*"/, "\"" newprof "\""); } { print }' ./flake.nix.bak >./flake.nix
cp ./flake.nix ./flake.nix.bak
awk -v newuser="$installusername" '/^ username = / { gsub(/"[^"]*"/, "\"" newuser "\""); } { print }' ./flake.nix.bak >./flake.nix
sed -i 's|^[[:space:]]*host[[:space:]]*=[[:space:]]*"[^"]*"| host = "'$hostName'"|' ./flake.nix.bak
# Use sed for profile (handles variable indentation)
sed -i 's|^[[:space:]]*profile[[:space:]]*=[[:space:]]*"[^"]*";| profile = "'$profile'";|' ./flake.nix.bak
# Use sed for username (handles variable indentation)
sed -i 's|^[[:space:]]*username[[:space:]]*=[[:space:]]*"[^"]*";| username = "'$installusername'";|' ./flake.nix.bak
echo -e "${GREEN}After sed replacements:${NC}"
grep -E "(host|profile|username) =" ./flake.nix.bak
cp ./flake.nix.bak ./flake.nix
rm ./flake.nix.bak
# Update timezone in system.nix
@ -323,6 +360,13 @@ rm ./hosts/$hostName/variables.nix.bak
echo "Configuration files updated successfully!"
print_header "Git Configuration"
git config --global user.name "$gitUsername"
git config --global user.email "$gitEmail"
git add .
git config --global --unset-all user.name
git config --global --unset-all user.email
print_header "Generating Hardware Configuration -- Ignore ERROR: cannot access /bin"
sudo nixos-generate-config --show-hardware-config >./hosts/$hostName/hardware.nix

View file

@ -1,8 +1,6 @@
{ host, ... }:
let
{host, ...}: let
inherit (import ../../hosts/${host}/variables.nix) consoleKeyMap;
in
{
in {
nix = {
settings = {
download-buffer-size = 200000000;
@ -11,8 +9,8 @@ in
"nix-command"
"flakes"
];
substituters = [ "https://hyprland.cachix.org" ];
trusted-public-keys = [ "hyprland.cachix.org-1:a7pgxzMz7+chwVL3/pzj6jIBMioiJM7ypFP8PwtkuGc=" ];
substituters = ["https://hyprland.cachix.org"];
trusted-public-keys = ["hyprland.cachix.org-1:a7pgxzMz7+chwVL3/pzj6jIBMioiJM7ypFP8PwtkuGc="];
};
};
time.timeZone = "America/New_York";
@ -30,7 +28,7 @@ in
};
environment.variables = {
NIXOS_OZONE_WL = "1";
ZANEYOS_VERSION = "2.5.0";
ZANEYOS_VERSION = "2.5.1";
ZANEYOS = "true";
};
console.keyMap = "${consoleKeyMap}";