Skip to content

Commit

Permalink
arch install updated
Browse files Browse the repository at this point in the history
  • Loading branch information
Pistonight committed Oct 22, 2024
1 parent 9d29738 commit 4e0c514
Show file tree
Hide file tree
Showing 25 changed files with 692 additions and 255 deletions.
7 changes: 7 additions & 0 deletions Taskfile.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,13 @@ tasks:
cmds:
- npx vitepress build src

clean:
desc: Clean dependencies and temporaries
cmds:
- rm -rf node_modules
- rm -rf src/.vitepress/cache
- rm -rf src/.vitepress/dist

starship:
desc: Copy starship.toml from home to repo
cmds:
Expand Down
72 changes: 46 additions & 26 deletions src/.vitepress/config.mts
Original file line number Diff line number Diff line change
@@ -1,30 +1,5 @@
import { defineConfig } from "vitepress"

const archSidebar = [
{
text: "Hyper-V Setup",
items: [
{ text: "Getting Started", link: "/arch/" },
{ text: "Creating VM", link: "/hyperv/create" },
{ text: "Virtual Switch", link: "/hyperv/virtual-switch" },
{ text: "Configure VM", link: "/hyperv/configure" },
]
}, {
text: "Install Arch Linux",
items: [
{ text: "Getting the Image", link: "/arch/download-iso" },
{ text: "Boot the Installer", link: "/arch/boot-installer" },
{ text: "Preinstall Checks", link: "/arch/preinstall-checks" },
{ text: "Disk Setup", link: "/arch/disk-setup" },
{ text: "Essential Packages", link: "/arch/essential-packages" },
{ text: "Configure the System", link: "/arch/configure" },
{ text: "Configure Boot Loader", link: "/arch/boot-loader" },
{ text: "Configure User", link: "/arch/user" },
{ text: "Conclusion", link: "/arch/conclusion" },
]
},
];

const windowsSidebar = [
{
text: "Windows Essentials",
Expand Down Expand Up @@ -54,6 +29,50 @@ const windowsSidebar = [
}
];

const hypervSidebar = [
{
text: "Hyper-V Setup",
items: [
{ text: "Getting Started", link: "/hyperv/" },
{ text: "Creating VM", link: "/hyperv/create" },
{ text: "Virtual Switch", link: "/hyperv/virtual-switch" },
{ text: "Configure VM", link: "/hyperv/configure" },
{ text: "Connect to a VM", link: "/hyperv/connect" },
{ text: "Next Steps", link: "/hyperv/next" },
]
}
];

const archSidebar = [
{
text: "System Install",
items: [
{ text: "Getting Started", link: "/arch/" },
{ text: "Getting the Image", link: "/arch/download-iso" },
{ text: "Boot Live Environment", link: "/arch/boot-installer" },
{ text: "Preinstall Checks", link: "/arch/preinstall-checks" },
{ text: "Disk Setup", link: "/arch/disk-setup" },
{ text: "Essential Packages", link: "/arch/essential-packages" },
{ text: "Configure the System", link: "/arch/configure" },
{ text: "Configure Boot Loader", link: "/arch/boot-loader" },
{ text: "Configure User", link: "/arch/user" },
{ text: "Next Steps", link: "/arch/next" },
]
},
{
text: "Desktop Environment",
items: [
{ text: "TODO", link: "/arch/de/" },
]
},
{
text: "Arch Essentials",
items: [
{ text: "TODO", link: "/arch/tool/essentials" },
]
},
];

const toolSidebar = [
{
text: "Essentials",
Expand Down Expand Up @@ -111,10 +130,11 @@ export default defineConfig({
{ text: "Hyper-V", link: "/hyperv" },
{ text: "Arch", link: "/arch/" },
{ text: "Tools", link: "/tool/" },
{ text: "Production", link: "/prod/" },
],
sidebar: {
"/windows/": windowsSidebar,
"/hyperv/": archSidebar,
"/hyperv/": hypervSidebar,
"/arch/": archSidebar,
"/tool/": toolSidebar,
},
Expand Down
102 changes: 91 additions & 11 deletions src/arch/boot-installer.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,20 @@
# Boot Installer

## Booting from the ISO
:::warning
Make sure Secure Boot is disabled when booting the install medium.

For Hyper-V, see [here](../hyperv/configure.md#disable-secure-boot)

For physical machines, see the manufacturer's documentation.

Secure Boot can be enabled later for physical machines. It's unnecessary for VMs.
:::

This section is 1.4-1.7 of the [Arch Linux Installation Guide](https://wiki.archlinux.org/title/Installation_guide).

## Boot Install Image

### In Hyper-V
1. Once again open Hyper-V Manager.
2. Select your VM, and click `Settings`
3. Select `SCSI Controller` on the left
Expand All @@ -15,26 +29,92 @@
:::warning
If you don't see anything, double check that you have `Secure Boot` disabled
:::
12. Select `Arch Linux install medium (x86_64, UEFI)`, should be the first option
13. Wait until you see the command prompt like

### On Physical Machine
With Secure Boot disabled, insert the bootable USB and boot from it.

## Enter the Install Medium
Select `Arch Linux install medium (x86_64, UEFI)`, which should be the first option,
then, Wait until you see the command prompt like
```
root@archiso ~ #
```

## Connect to internet
:::tip
For Ethernet connection, it will automatically work when the cable is plugged in.

For Hyper-V, make sure the external virtual switch is connected to the correct network adapter. See [here](../hyperv/virtual-switch.md)
:::

To connect to internet using Wi-Fi, run
```bash
iwctl
```
List the Wi-Fi devices
```
device list
```
:::warning
We will assume the Wi-Fi device is `wlan0`. See the output of `device list` to confirm the device name.
:::
If the device is powered off, turn it on
```
device wlan0 set-property Powered on
```
Then, initiate a scan (note there will be no output) and list available networks
```
station wlan0 scan
station wlan0 get-networks
```

To connect to a network, run the following, and type in the password.
```
station wlan0 connect <SSID>
```

Then, exit by
```
quit
```

## Verify internet connection
1. Run `ip address`
2. You should see an local address starting with `192.168` indicating that your VM is connected to your local network. If not, you might need to change the network adapter the external virtual switch is connecting to.
3. Run `ping archlinux.org` to verify connection
4. Ctrl-C to stop pinging

First verify that your machine is connected to the local network
```bash
ip address
```
You should see an local address starting with `192.168` indicating that the machine is connected to your local network.
:::tip
For Hyper-V, if the connection is not working, you might need to change the network adapter the external virtual switch is connecting to.
:::

Then, verify you have internet connection
```bash
ping archlinux.org
```
Press `Ctrl-C` to stop pinging

## Setup SSH
1. Run `passwd` to set the root password
With SSH, we can install the system from the device you are reading this guide on.
So you can copy and paste commands from this guide to the terminal.

Run `passwd` to set a short, temporary password
:::tip
This will not be the root password for the OS you are installing. This is the root password for the live environment. Type something simple like `change` so you can type it quickly.
:::
2. Inside Powershell, ssh to the VM. Replace `<ip-address>` with the IP address you got from `ip address`

Then, on the host system, run
```
ssh root@<ip-address>
```
3. Enter the password you just set
4. You should now see the same prompt
:::tip
Replace `<ip-address>` with the IP address you got from `ip address`
:::
Enter the password you just set, and you should now see the same prompt
```
root@archiso ~ #
```
:::warning
Keep your new machine/VM running!
:::
Loading

0 comments on commit 4e0c514

Please sign in to comment.