feat(content): add Alpine Linux install guide
All checks were successful
build dist / build-dist (push) Successful in 36s
All checks were successful
build dist / build-dist (push) Successful in 36s
This commit is contained in:
parent
04f7e92c7d
commit
54029c994c
2 changed files with 194 additions and 6 deletions
12
package.json
12
package.json
|
|
@ -15,13 +15,13 @@
|
|||
"dependencies": {
|
||||
"@astrojs/markdown-remark": "^6.3.1",
|
||||
"@astrojs/partytown": "^2.1.4",
|
||||
"@astrojs/react": "^4.2.5",
|
||||
"@astrojs/react": "^4.2.7",
|
||||
"@astrojs/rss": "^4.0.11",
|
||||
"@astrojs/sitemap": "^3.3.1",
|
||||
"@expressive-code/plugin-collapsible-sections": "^0.40.2",
|
||||
"@expressive-code/plugin-line-numbers": "^0.40.2",
|
||||
"@fontsource-variable/geist": "^5.2.5",
|
||||
"@fontsource-variable/geist-mono": "^5.2.5",
|
||||
"@fontsource-variable/geist": "^5.2.6",
|
||||
"@fontsource-variable/geist-mono": "^5.2.6",
|
||||
"@iconify-json/lucide": "^1.2.39",
|
||||
"@iconify-json/simple-icons": "^1.2.33",
|
||||
"@r4ai/remark-callout": "^0.6.2",
|
||||
|
|
@ -29,11 +29,11 @@
|
|||
"@radix-ui/react-scroll-area": "^1.2.6",
|
||||
"@radix-ui/react-separator": "^1.1.4",
|
||||
"@radix-ui/react-slot": "^1.2.0",
|
||||
"@tailwindcss/vite": "^4.1.4",
|
||||
"@tailwindcss/vite": "^4.1.5",
|
||||
"@types/react": "19.0.0",
|
||||
"@types/react-dom": "19.0.0",
|
||||
"@yeskunall/astro-umami": "^0.0.5",
|
||||
"astro": "^5.7.5",
|
||||
"astro": "^5.7.10",
|
||||
"astro-expressive-code": "^0.40.2",
|
||||
"astro-icon": "^1.1.5",
|
||||
"class-variance-authority": "^0.7.1",
|
||||
|
|
@ -51,7 +51,7 @@
|
|||
"remark-sectionize": "^2.1.0",
|
||||
"remark-toc": "^9.0.0",
|
||||
"tailwind-merge": "^3.2.0",
|
||||
"tailwindcss": "^4.1.4",
|
||||
"tailwindcss": "^4.1.5",
|
||||
"typescript": "^5.8.3"
|
||||
},
|
||||
"devDependencies": {
|
||||
|
|
|
|||
188
src/content/alpine-install-guide/index.md
vendored
Normal file
188
src/content/alpine-install-guide/index.md
vendored
Normal file
|
|
@ -0,0 +1,188 @@
|
|||
---
|
||||
title: Alpine Linux install guide
|
||||
description: Guide to installing Alpine Linux with full disk encryption
|
||||
date: 2025-05-04
|
||||
---
|
||||
|
||||
---
|
||||
|
||||
## Introduction
|
||||
|
||||
The goal of this guide is to set up a minimal installation of **Alpine Linux** with **full disk encryption**. Refer to the [Alpine installation wiki](https://wiki.alpinelinux.org/wiki/Installation) if encounterung any issues
|
||||
|
||||
---
|
||||
|
||||
## Acquire an installation image
|
||||
|
||||
1. Go to the downloads page https://www.alpinelinux.org/downloads
|
||||
2. Under the **Standard** section, download the `x86_64` version
|
||||
|
||||
---
|
||||
|
||||
## Prepare an installation medium
|
||||
|
||||
### Linux
|
||||
|
||||
1. Insert a USB flash drive into your PC with at least 2 GB of space available on it.
|
||||
2. Find the corresponding block device for the flash drive in `/dev` folder. Usually it is `/dev/sdb1`.
|
||||
3. Write the image to the flash drive (assuming your flash drive is `/dev/sdb1`).
|
||||
|
||||
> [!warning]
|
||||
> This command will wipe the `/dev/sdb1` partition
|
||||
|
||||
|
||||
```sh
|
||||
doas dd bs=4M if=~/Downloads/alpine*x86_64.iso of=/dev/sdb1 conv=fsync oflag=direct status=progress
|
||||
```
|
||||
|
||||
### Windows
|
||||
|
||||
Use [Rufus](https://rufus.ie/en)
|
||||
|
||||
---
|
||||
|
||||
## Boot the live environment
|
||||
|
||||
> [!info]
|
||||
> Alpine Linux installation images do not support Secure Boot. You will need to disable Secure Boot in your BIOS to boot the installation medium.
|
||||
|
||||
1. Power off your PC.
|
||||
2. Insert the flash drive into the computer on which you are installing Alpine Linux.
|
||||
3. Power on your PC and press your *boot menu* key.
|
||||
4. Boot the installation medium.
|
||||
|
||||
---
|
||||
|
||||
## Enter the live environment
|
||||
|
||||
Log in as the user `root`. Initially, the **root** user has no password.
|
||||
|
||||
> [!note]
|
||||
> `nvme0n1` will be used as the target install drive throughout this guide, adapt it to your drive name.
|
||||
|
||||
> [!tip]
|
||||
>Change `alpine` to your desired hostname and `system` to your desired username.
|
||||
>
|
||||
>Change `Asia/Dubai` to your timezone.
|
||||
|
||||
```sh
|
||||
setup-alpine
|
||||
```
|
||||
|
||||
```md showLineNumbers=false
|
||||
Select keyboard layout: us
|
||||
Select variant: us
|
||||
Enter system hostname: alpine
|
||||
Which one do you want to initialize?: [enter]
|
||||
Ip address for [your_interface]?: dhcp
|
||||
Do you want to do any manual network configuration?: n
|
||||
New password: [your_root_password]
|
||||
Retype password: [your_root_password]
|
||||
Which timezone are you in?: Asia/Dubai
|
||||
HTTP/FTP proxy URL?: none
|
||||
Enter mirror number: f
|
||||
Setup a user?: system
|
||||
Full name for user system?: system
|
||||
New password:
|
||||
Retype password:
|
||||
Enter ssh key or URL for system: none
|
||||
Which SSH server?: openssh
|
||||
Which NTP client to run?: chrony
|
||||
Which disks would you like to use?: nvme0n1
|
||||
How would you like to use it?: cryptsys
|
||||
Erase above disks and continue?: y
|
||||
Enter passphrase for /dev/nvme0n1p2: [your_encryption_passphrase]
|
||||
Verify passphrase: [your_encryption_passphrase]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Reboot
|
||||
|
||||
1. You can now reboot and enter into your new installation
|
||||
|
||||
> [!note]
|
||||
> Unplug your flash drive after the screen turns black
|
||||
|
||||
```sh
|
||||
reboot
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Post install
|
||||
|
||||
After entering the decryption passphrase, you will be greeted with a similar screen as when you first booted from the flash drive.
|
||||
Login using the credentials that you set, if you followed the example, your username would be `system`
|
||||
|
||||
### Add repositories
|
||||
|
||||
> [!note]
|
||||
> Testing will not be used by default, but you can install a package from it like so:
|
||||
>
|
||||
>```sh
|
||||
>doas apk add [your_package]@testing
|
||||
>```
|
||||
|
||||
|
||||
```sh
|
||||
doas apk update
|
||||
doas apk upgrade
|
||||
```
|
||||
|
||||
### Add swap
|
||||
|
||||
```sh
|
||||
doas apk add e2fsprogs-extra
|
||||
doas fallocate -l 4G /swapfile
|
||||
doas chmod 600 /swapfile
|
||||
doas mkswap /swapfile
|
||||
doas swapon /swapfile
|
||||
doas cp /etc/fstab /etc/fstab.bak
|
||||
echo '/swapfile none swap sw 0 0' | doas tee -a /etc/fstab
|
||||
|
||||
doas swapoff /dev/nvme0n1/lv_swap
|
||||
doas lvremove /dev/nvme0n1/lv_swap
|
||||
doas lvextend -l +100%FREE /dev/nvme0n1/lv_root
|
||||
doas resize2fs /dev/nvme0n1/lv_root
|
||||
```
|
||||
|
||||
```diff
|
||||
<!-- /etc/fstab -->
|
||||
-/dev/nvme0n1/lv_swap none swap defaults 0 0
|
||||
```
|
||||
|
||||
### Install Docker
|
||||
|
||||
```md
|
||||
<!-- ~/.zshenv -->
|
||||
export EDITOR=nvim
|
||||
export XDG_CONFIG_HOME="$HOME/.config"
|
||||
export XDG_DATA_HOME="$HOME/.local/share"
|
||||
export XDG_BIN_HOME="$HOME/.local/bin"
|
||||
export XDG_STATE_HOME="$HOME/.local/state"
|
||||
export XDG_CACHE_HOME="$HOME/.cache"
|
||||
export XDG_RUNTIME_DIR=/tmp/1000-runtime-dir
|
||||
export PATH="$XDG_BIN_HOME:$PATH"
|
||||
export ZDOTDIR="$XDG_CONFIG_HOME/zsh"
|
||||
```
|
||||
|
||||
```sh
|
||||
doas apk add docker docker-cli-compose zsh shadow neovim
|
||||
chsh -s zsh $USER
|
||||
doas addgroup $USER docker
|
||||
doas rc-update add docker && rc-service docker start
|
||||
doas apk del shadow
|
||||
```
|
||||
|
||||
#### WG-Easy
|
||||
|
||||
If you’re planning to use [wg-easy](https://github.com/wg-easy/wg-easy), save yourself hours of troubleshooting by running the following commands
|
||||
|
||||
```sh
|
||||
doas apk add iptables ip6tables
|
||||
doas reboot
|
||||
doas modprobe ip_tables
|
||||
doas echo 'ip_tables' >> /etc/modules
|
||||
doas reboot
|
||||
```
|
||||
Loading…
Add table
Add a link
Reference in a new issue