Commit Briefs

Branches

Tags

Tree

.forgejo/
.guix-authorizationscommits | blame
.guix-channelcommits | blame
LICENSEcommits | blame
README.mdcommits | blame
README.txtcommits | blame
richard/
scripts/
system/

README.txt

guix-channel

Canal personal de GNU Guix para el Nitro 5	Richard Bernal Estrada.

Canal con paquetes binarios y configuracin de sistema para el Acer Nitro
5 (Intel UHD 630 + GTX 1050 Max-Q, PRIME Render Offload, KDE Plasma).



Estructura
----------

   guix-channel/
	.forgejo/workflows/
	   audit.yml		CI: verificacin esttica automtica
	richard/
	   packages/
	      zen-browser.scm  Zen Browser 1.12.9b (binary wrap)
	      mullvad.scm      Mullvad VPN 2026.1 (binary wrap desde .deb)
	   services/
	       mullvad.scm	Servicio Shepherd para mullvad-daemon
	scripts/
	   audit.py		Script de verificacin esttica (58 checks)
	system/
	    channels.scm	 Canales: guix + nonguix + este canal
	    config.scm		 Configuracin del sistema (/etc/config.scm)
	    home.scm		 Guix Home: GPG, YubiKey, bash



Agregar el canal
----------------

Aade esto a ~/.config/guix/channels.scm:

   (channel
	 (name 'richard)
	 (url "https://codeberg.org/Richard7987/guix-channel")
	 (branch "main")
	 (introduction
	   (make-channel-introduction
	     "17ca291dac7ec48ce8266b3726d1fdcc513e99f7"
	     (openpgp-fingerprint
	       "91CA 581F 7B78 01E8 8673  D228 DBD5 F61D 8A0A 14D7"))))

Luego:

   guix pull
   guix install zen-browser	 # o mullvad-vpn



Instalar el sistema completo (Nitro 5)
--------------------------------------

   # 1. Clonar el repo
   git clone git@codeberg.org:Richard7987/guix-channel.git ~/guix-channel

   # 2. Copiar configuraciones
   sudo cp ~/guix-channel/system/config.scm /etc/config.scm
   mkdir -p ~/.config/guix
   cp ~/guix-channel/system/channels.scm ~/.config/guix/channels.scm

   # 3. Actualizar canales y reconfigurar
   guix pull
   sudo guix system reconfigure /etc/config.scm

   # 4. Aplicar configuracin de usuario (Guix Home)
   guix home reconfigure ~/guix-channel/system/home.scm



Paquetes incluidos
------------------

Zen Browser (zen-browser)
-------------------------

Fork de Firefox enfocado en privacidad con barra lateral y espacios de
trabajo. Empaquetado como binary wrap desde el tarball oficial de GitHub.

   guix install zen-browser

Para actualizar a una versin nueva:

   # 1. Editar richard/packages/zen-browser.scm  cambiar 'version'
   # 2. Obtener el hash nuevo:
   guix download https://github.com/zen-browser/desktop/releases/download/VERSION/zen.linux-x86_64.tar.xz
   # 3. Reemplazar el (base32 "...") con el hash obtenido
   git commit -am "zen-browser: actualizar a VERSION"
   git push

Mullvad VPN (mullvad-vpn + servicio Shepherd)
---------------------------------------------

Cliente VPN centrado en privacidad. Incluye daemon (mullvad-daemon) y CLI (mullvad).
El daemon arranca automticamente con el sistema.

   # Tras instalar el sistema, activar la cuenta:
   mullvad account login TU_NUMERO_DE_CUENTA

   # Conectar
   mullvad relay set location mx   # servidores en Mxico
   mullvad connect

   # Estado
   mullvad status
   herd status mullvad

Para actualizar:

   # 1. Editar richard/packages/mullvad.scm	 cambiar 'version'
   # 2. Obtener el hash:
   wget https://github.com/mullvad/mullvadvpn-app/releases/download/VERSION/MullvadVPN-VERSION_amd64.deb
   sha256sum MullvadVPN-VERSION_amd64.deb | python3 scripts/nix32.py
   # 3. Reemplazar el (base32 "...") con el resultado



Hardware objetivo
-----------------

Componente	Detalle

Laptop	Acer Nitro 5
CPU		Intel Coffee Lake-H
iGPU	Intel UHD 630 (PCI:0:2:0)
dGPU	NVIDIA GTX 1050 3 GB Max-Q (PCI:1:0:0)
GPU Mode	PRIME Render Offload (sin MUX switch)
DE		KDE Plasma 6 + SDDM
Kernel	Linux no-libre (nonguix)

Verificar PRIME tras instalar
-----------------------------

   # Debe mostrar Intel/Mesa
   glxinfo | grep "OpenGL renderer"

   # Debe mostrar NVIDIA GTX 1050
   __NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia \
	 glxinfo | grep "OpenGL renderer"

   # Lanzar Blender con NVIDIA
   __NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia blender



Versionado
----------

Este proyecto usa CalVer (YYYY.N):

Versin  Fecha      Cambios

v2026.1   Mayo 2026	 Versin inicial: KDE Plasma, PRIME Offload, Mullvad, Zen Browser, YubiKey

Para crear un nuevo release en Codeberg:

   git tag v2026.2
   git push origin v2026.2



CI  Verificacin esttica
-----------------------

El script scripts/audit.py corre 58 checks automticos en cada push:

   Validez de hashes nix32 (formato y longitud)
   Imports de mdulos requeridos en todos los archivos .scm
   Presencia de servicios crticos (nvidia-service-type,
	sddm-service-type, etc.)
   Configuracin PRIME (BusID, AllowNVIDIAGPUScreens, nvda)
   Paquetes requeridos en el sistema
   Configuracin de Guix Home (GPG, YubiKey, pinentry)

   # Correr localmente
   python3 scripts/audit.py



Licencia
--------

GPL-3.0  ver LICENSE LICENSE