translate all docs to English
Translate 8 documentation files from German to English: - docs/index.md (complete) - docs/getting-started/first-install.md (complete) - docs/getting-started/new-client.md (complete) - docs/getting-started/reinstall.md (complete) - docs/getting-started/sd-image.md (complete) - docs/deployment/dns.md (PTR, Hetzner, checklist sections) - docs/services/tailscale.md (code comments) - docs/services/forgejo.md (placeholder names)
This commit is contained in:
parent
c81b43530a
commit
a0da5be8fc
8 changed files with 386 additions and 386 deletions
|
|
@ -1,95 +1,95 @@
|
|||
# SD-Karten-Images für Raspberry Pi
|
||||
# SD Card Images for Raspberry Pi
|
||||
|
||||
Das Repository baut automatisch SD-Karten-Images für alle konfigurierten Raspberry Pi Hosts.
|
||||
The repository automatically builds SD card images for all configured Raspberry Pi hosts.
|
||||
|
||||
## Automatischer Build
|
||||
## Automatic Build
|
||||
|
||||
Bei Änderungen an `main` werden automatisch Images für alle Pi-Hosts gebaut und als Release veröffentlicht.
|
||||
When changes are pushed to `main`, images are automatically built for all Pi hosts and published as a release.
|
||||
|
||||
**Download:** [Releases auf Forgejo](https://git.cryodev.xyz/steffen/cryodev-server/releases)
|
||||
**Download:** [Releases on Forgejo](https://git.cryodev.xyz/steffen/cryodev-server/releases)
|
||||
|
||||
## Verfügbare Images
|
||||
## Available Images
|
||||
|
||||
| Host | Image-Name |
|
||||
| Host | Image Name |
|
||||
|------|------------|
|
||||
| `cryodev-pi` | `cryodev-pi-sd-image.img.zst` |
|
||||
|
||||
Neue Hosts werden automatisch gebaut, wenn sie zur Workflow-Matrix hinzugefügt werden.
|
||||
New hosts are built automatically once they are added to the workflow matrix.
|
||||
|
||||
## Image flashen
|
||||
## Flashing the Image
|
||||
|
||||
### 1. Herunterladen
|
||||
### 1. Download
|
||||
|
||||
```bash
|
||||
wget https://git.cryodev.xyz/.../releases/latest/download/<hostname>-sd-image.img.zst
|
||||
wget https://git.cryodev.xyz/.../releases/latest/download/<hostname>-sd-image.img.zst.sha256
|
||||
|
||||
# Checksum prüfen
|
||||
# Verify checksum
|
||||
sha256sum -c <hostname>-sd-image.img.zst.sha256
|
||||
```
|
||||
|
||||
### 2. Dekomprimieren
|
||||
### 2. Decompress
|
||||
|
||||
```bash
|
||||
zstd -d <hostname>-sd-image.img.zst -o <hostname>.img
|
||||
```
|
||||
|
||||
### 3. Auf SD-Karte schreiben
|
||||
### 3. Write to SD Card
|
||||
|
||||
```bash
|
||||
# Richtiges Gerät finden
|
||||
# Identify the correct device
|
||||
lsblk
|
||||
|
||||
# Schreiben (ACHTUNG: richtiges Gerät wählen!)
|
||||
# Write (WARNING: make sure to select the correct device!)
|
||||
sudo dd if=<hostname>.img of=/dev/sdX bs=4M conv=fsync status=progress
|
||||
```
|
||||
|
||||
Alternativ: `balenaEtcher` oder `Raspberry Pi Imager` verwenden.
|
||||
Alternatively, use `balenaEtcher` or `Raspberry Pi Imager`.
|
||||
|
||||
## Was ist im Image?
|
||||
## What Is Included in the Image?
|
||||
|
||||
- Vollständige NixOS-Installation für den spezifischen Host
|
||||
- Alle konfigurierten Services (außer Secrets)
|
||||
- SSH-Server aktiviert
|
||||
- Automatische Root-Partition-Erweiterung beim ersten Boot
|
||||
- Comin für automatische Updates
|
||||
- Complete NixOS installation for the specific host
|
||||
- All configured services (except secrets)
|
||||
- SSH server enabled
|
||||
- Automatic root partition expansion on first boot
|
||||
- Comin for automatic updates
|
||||
|
||||
## Was fehlt?
|
||||
## What Is Missing?
|
||||
|
||||
**SOPS-Secrets** können nicht im Image enthalten sein (Henne-Ei-Problem mit SSH-Host-Key).
|
||||
**SOPS secrets** cannot be included in the image (chicken-and-egg problem with the SSH host key).
|
||||
|
||||
Nach dem ersten Boot:
|
||||
1. Age-Key vom Pi holen
|
||||
2. `.sops.yaml` aktualisieren
|
||||
3. `secrets.yaml` erstellen
|
||||
4. Konfiguration deployen
|
||||
After the first boot:
|
||||
1. Retrieve the age key from the Pi
|
||||
2. Update `.sops.yaml`
|
||||
3. Create `secrets.yaml`
|
||||
4. Deploy the configuration
|
||||
|
||||
Siehe [Neuen Client hinzufügen](new-client.md) für die vollständige Anleitung.
|
||||
See [Adding a New Client](new-client.md) for the complete guide.
|
||||
|
||||
## Neuen Host zur Pipeline hinzufügen
|
||||
## Adding a New Host to the Pipeline
|
||||
|
||||
1. Host-Konfiguration in `hosts/<hostname>/` erstellen
|
||||
2. In `.forgejo/workflows/build-pi-image.yml` zur Matrix hinzufügen:
|
||||
1. Create the host configuration in `hosts/<hostname>/`
|
||||
2. Add it to the matrix in `.forgejo/workflows/build-pi-image.yml`:
|
||||
|
||||
```yaml
|
||||
matrix:
|
||||
host: [cryodev-pi, neuer-host] # <- hier hinzufügen
|
||||
host: [cryodev-pi, new-host] # <- add here
|
||||
```
|
||||
|
||||
3. Push auf `main` → Image wird automatisch gebaut
|
||||
3. Push to `main` -- the image will be built automatically
|
||||
|
||||
## Manuell bauen
|
||||
## Building Manually
|
||||
|
||||
```bash
|
||||
# Auf aarch64 (z.B. anderem Pi)
|
||||
# On aarch64 (e.g., another Pi)
|
||||
nix build .#nixosConfigurations.<hostname>.config.system.build.sdImage
|
||||
|
||||
# Auf x86_64 mit QEMU-Emulation (langsam)
|
||||
# On x86_64 with QEMU emulation (slow)
|
||||
nix build .#nixosConfigurations.<hostname>.config.system.build.sdImage \
|
||||
--extra-platforms aarch64-linux
|
||||
```
|
||||
|
||||
Voraussetzung auf x86_64:
|
||||
Prerequisite on x86_64:
|
||||
|
||||
```nix
|
||||
{
|
||||
|
|
@ -99,18 +99,18 @@ Voraussetzung auf x86_64:
|
|||
|
||||
## Troubleshooting
|
||||
|
||||
### Workflow schlägt fehl
|
||||
### Workflow Fails
|
||||
|
||||
- Prüfe ob `sd-image.nix` in der Host-Konfiguration importiert wird
|
||||
- Prüfe ob binfmt auf cryodev-main aktiviert ist
|
||||
- Check whether `sd-image.nix` is imported in the host configuration
|
||||
- Check whether binfmt is enabled on cryodev-main
|
||||
|
||||
### Image bootet nicht
|
||||
### Image Does Not Boot
|
||||
|
||||
- SD-Karte korrekt beschrieben?
|
||||
- Andere SD-Karte versuchen
|
||||
- Stromversorgung prüfen (min. 3A für Pi 4)
|
||||
- Was the SD card written correctly?
|
||||
- Try a different SD card
|
||||
- Check the power supply (minimum 3A for Pi 4)
|
||||
|
||||
### Kein Netzwerk
|
||||
### No Network
|
||||
|
||||
- Ethernet-Kabel prüfen
|
||||
- DHCP-Server im Netzwerk?
|
||||
- Check the Ethernet cable
|
||||
- Is there a DHCP server on the network?
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue