Skip to content

Commit adb0f6c

Browse files
author
Alexia Michelle
committed
introduce GoldenDog installation and NVIDIA driver documentation in English and Spanish, and refine footer styling.
1 parent e3edfdf commit adb0f6c

5 files changed

Lines changed: 146 additions & 2 deletions

File tree

docs/installing-goldendog.md

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
sidebar_position: 3
3+
---
4+
5+
# Installing GoldenDog Linux
6+
7+
Installing GoldenDog is a straightforward process, whether you are installing it on a physical computer or a virtual machine.
8+
9+
## Before You Start
10+
11+
You can install GoldenDog on:
12+
- **Physical Hardware**: See the [Media Creation Guide](./installation-guide.md) to prepare your USB drive.
13+
- **Virtual Machines**: For a quick and easy test, you can use **[Alexia's Spin VM](https://github.com/alexiarstein/spin-vm)**. It creates an instant VM with a 20GB virtual disk, which is perfect for testing GoldenDog.
14+
15+
:::info Supported Architecture
16+
GoldenDog Linux currently only supports **amd64** (64-bit Intel/AMD) architectures. It does not support Raspberry Pi or RISC-V.
17+
If you need those, check the [Debian Ports](https://wiki.debian.org/Ports/riscv64) or [Raspberry Pi images](https://raspi.debian.net/tested-images/).
18+
:::
19+
20+
## Installation Steps
21+
22+
### 1. Language & Region
23+
Selecting your language and region correctly is vital for your system's date, time, and locale settings.
24+
- You can select a language different from your region (e.g., English language with Argentina region).
25+
- If your country is not listed under your chosen language, select **"Other"** to find your specific location.
26+
27+
### 2. Network Configuration
28+
The installer will scan for network devices.
29+
- **Laptops**: The installer usually detects WiFi cards (often named `wlp*`).
30+
- **WiFi Setup**: Select your wireless card, choose your network, and provide the password (usually **WPA/PSK**).
31+
32+
### 3. Hostname & Domain
33+
- **Hostname**: This is the "name" of your machine on the network. The default is `goldendog`, but you can change it to anything you like.
34+
- **Domain Name**: This is for identification within a network. If you're not sure, you can use any name or leave it at the default.
35+
36+
### 4. User & Root Accounts
37+
You will be asked to set up two types of accounts:
38+
- **Root Account**: The system administrator. It is highly recommended to choose a **different password** than your personal user account.
39+
- *Tip*: If you leave the root password blank, the root account will be disabled for direct login, but your user will be granted administrator rights via `sudo`.
40+
- **User Account**: This will be your primary account. This first account created is automatically added to the `sudo` group.
41+
42+
### 5. Disk Partitioning
43+
- **New Users**: Select **"Guided - use entire disk"** and **"All files in one partition"**. This is the safest and easiest option for laptops or testing.
44+
- **Advanced Users**: Only use **LVM** (Logical Volume Manager) if you are deploying a server or have multiple hard drives and are familiar with how it works.
45+
46+
:::important
47+
You must select **"Write changes to disk"** to commit the partitioning and proceed.
48+
:::
49+
50+
### 6. System Configuration
51+
- **Proxy Settings**: Most users should leave this field **blank**. Only enter information here if you are in a corporate or office environment that requires a proxy (e.g., `user:pass@proxy:port`).
52+
- **Popularity Contest**: This helps the Debian project (which GoldenDog supports 100%) by anonymously reporting which packages are most used. You can safely select "No" if you prefer privacy.
53+
54+
### 7. Installing GRUB
55+
GRUB is the bootloader that allows your computer to start Linux.
56+
- The installer will automatically detect where to install it (usually the Master Boot Record / MBR). Select the suggested drive to complete the installation.
57+
58+
## First Boot
59+
Once finished, the system will reboot into GoldenDog. The first boot might take a few extra seconds as the system runs post-installation cleanup and sanitization tasks.
60+
61+
## Video Drivers
62+
- **Intel / AMD**: GoldenDog will try to automatically install the correct drivers for you.
63+
- **NVIDIA**: If you have an NVIDIA card, please refer to our **[NVIDIA Driver Guide](./nvidia-drivers.md)** for installation instructions.

docs/nvidia-drivers.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
sidebar_position: 4
3+
---
4+
5+
# NVIDIA Driver Installation
6+
7+
This guide will cover the installation of NVIDIA proprietary drivers on GoldenDog Linux.
8+
9+
*(Content coming soon... In the meantime, you can use the official Debian non-free repositories to install `nvidia-driver`.)*
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
sidebar_position: 3
3+
---
4+
5+
# Instalación de GoldenDog Linux
6+
7+
Instalar GoldenDog es un proceso sencillo, ya sea que lo instales en una computadora física o en una máquina virtual.
8+
9+
## Antes de Comenzar
10+
11+
Puedes instalar GoldenDog en:
12+
- **Hardware Físico**: Consulta la [Guía de Creación de Medios](./installation-guide.md) para preparar tu unidad USB.
13+
- **Máquinas Virtuales**: Para una prueba rápida y fácil, puedes usar **[Spin VM de Alexia](https://github.com/alexiarstein/spin-vm)**. Crea una VM instantánea con un disco virtual de 20GB, lo cual es perfecto para probar GoldenDog.
14+
15+
:::info Arquitectura Soportada
16+
GoldenDog Linux actualmente solo soporta arquitecturas **amd64** (Intel/AMD de 64 bits). No es compatible con Raspberry Pi ni RISC-V.
17+
Si necesitas esas versiones, consulta los [Puertos de Debian](https://wiki.debian.org/Ports/riscv64) o las [imágenes para Raspberry Pi](https://raspi.debian.net/tested-images/).
18+
:::
19+
20+
## Pasos de Instalación
21+
22+
### 1. Idioma y Región
23+
Seleccionar correctamente el idioma y la región es vital para la configuración de fecha, hora y localización del sistema.
24+
- Puedes seleccionar un idioma diferente al de tu región (por ejemplo, idioma inglés con región Argentina).
25+
- Si tu país no aparece en la lista bajo el idioma elegido, selecciona **"Otro"** (Other) para encontrar tu ubicación específica.
26+
27+
### 2. Configuración de Red
28+
El instalador buscará dispositivos de red.
29+
- **Laptops**: El instalador suele detectar las tarjetas WiFi (a menudo llamadas `wlp*`).
30+
- **Configuración WiFi**: Selecciona tu tarjeta inalámbrica, elige tu red y proporciona la contraseña (usualmente **WPA/PSK**).
31+
32+
### 3. Nombre de Host y Dominio
33+
- **Nombre de Host (Hostname)**: Es el "nombre" de tu máquina en la red. El valor predeterminado es `goldendog`, pero puedes cambiarlo por el que prefieras.
34+
- **Nombre de Dominio**: Sirve para la identificación dentro de una red. Si no estás seguro, puedes usar cualquier nombre o dejarlo como está.
35+
36+
### 4. Cuentas de Usuario y Root
37+
Se te pedirá configurar dos tipos de cuentas:
38+
- **Cuenta Root**: Es el administrador del sistema. Se recomienda encarecidamente elegir una **contraseña diferente** a la de tu cuenta de usuario personal.
39+
- *Consejo*: Si dejas la contraseña de root en blanco, la cuenta root se desactivará para el inicio de sesión directo, pero se le otorgarán permisos de administrador a tu usuario a través de `sudo`.
40+
- **Cuenta de Usuario**: Esta será tu cuenta principal. La primera cuenta creada se añade automáticamente al grupo `sudo`.
41+
42+
### 5. Particionado de Disco
43+
- **Nuevos Usuarios**: Selecciona **"Guiado - utilizar todo el disco"** y **"Todos los archivos en una partición"**. Esta es la opción más segura y fácil para laptops o pruebas.
44+
- **Usuarios Avanzados**: Solo utiliza **LVM** (*Logical Volume Manager*) si estás desplegando un servidor o tienes varios discos duros y estás familiarizado con su funcionamiento.
45+
46+
:::important
47+
Debes seleccionar **"Escribir cambios en el disco"** para confirmar el particionado y continuar.
48+
:::
49+
50+
### 6. Configuración del Sistema
51+
- **Configuración de Proxy**: La mayoría de los usuarios deben dejar este campo **en blanco**. Solo ingresa información aquí si te encuentras en un entorno corporativo o de oficina que requiera un proxy (ej. `usuario:pass@proxy:puerto`).
52+
- **Concurso de Popularidad (Popularity Contest)**: Esto ayuda al proyecto Debian (que GoldenDog apoya al 100%) informando anónimamente qué paquetes son los más utilizados. Puedes seleccionar "No" si prefieres mantener tu privacidad.
53+
54+
### 7. Instalación de GRUB
55+
GRUB es el cargador de arranque que permite que tu computadora inicie Linux.
56+
- El instalador detectará automáticamente dónde instalarlo (normalmente en el *Master Boot Record* / MBR). Selecciona la unidad sugerida para completar la instalación.
57+
58+
## Primer Inicio
59+
Una vez finalizado, el sistema se reiniciará en GoldenDog. El primer inicio puede tardar unos segundos extra mientras el sistema realiza tareas de limpieza y post-instalación.
60+
61+
## Controladores de Video
62+
- **Intel / AMD**: GoldenDog intentará instalar automáticamente los controladores correctos por ti.
63+
- **NVIDIA**: Si tienes una tarjeta NVIDIA, consulta nuestra **[Guía de Controladores NVIDIA](./nvidia-drivers.md)** para las instrucciones de instalación.
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
sidebar_position: 4
3+
---
4+
5+
# Instalación de Controladores NVIDIA
6+
7+
Esta guía cubrirá la instalación de los controladores propietarios de NVIDIA en GoldenDog Linux.
8+
9+
*(Contenido próximamente... Mientras tanto, puedes usar los repositorios oficiales non-free de Debian para instalar `nvidia-driver`.)*

src/css/custom.css

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,8 +63,8 @@
6363
}
6464

6565
.footer {
66-
background: radial-gradient(circle at center, rgba(255, 255, 255, 0.04) 0%, rgba(33, 15, 55, 0.5) 40%, #080112 100%);
67-
border-top: 1px solid rgba(255, 255, 255, 0.08);
66+
background: radial-gradient(circle at center, rgba(255, 255, 255, 0.03) 0%, rgba(26, 2, 51, 0.4) 30%, #080112 100%);
67+
border-top: 1px solid rgba(255, 255, 255, 0.05);
6868
text-align: center;
6969
padding: 4rem 0;
7070
}

0 commit comments

Comments
 (0)