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:
commit
58055efe6f
5 changed files with 425 additions and 214 deletions
33
CHANGELOG.md
33
CHANGELOG.md
|
|
@ -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
419
FAQ.es.md
|
|
@ -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
105
FAQ.md
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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}";
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue