pogmommy/wii-server-setup
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

update readme

Browse source
This commit is contained in:
Penelope Gwen 2025-06-10 10:03:26 -07:00
parent 8258270dbc
commit d2f041bb66
1 changed files with 27 additions and 27 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

54
README.md
View file

@ -28,43 +28,43 @@
5. Use the up/down arrow keys on your USB keyboard to select "BootMii IOS", then press enter
5. The first time Arch Linux boots, it may automatically reboot itself
6. Once Arch Linux has finished booting, login using the credentials printed at the top of the screen
- you should absolutely change this password with `passwd` after logging in.
7. If you do not have a compatible USB NIC, connect to a 2.4GHz wireless network using `nmtui`
8. Once a network connection is established, perform a full system upgrade using `pacman -Syu`.
- you should absolutely change this password with **`passwd`** after logging in.
7. If you do not have a compatible USB NIC, connect to a 2.4GHz wireless network using **`nmtui`**
8. Once a network connection is established, perform a full system upgrade using **`pacman -Syu`**.
- In my experience, this is much more stable on a wireless connection. Couldn't tell you why.
- this will take a long time. Go play Wii Sports while you wait.
## Setting up the web server on your wii
9. Install nginx, sudo, and git using `pacman -S nginx sudo git`
10. Create a new non-root user with `useradd --create-home [your username]`
11. Set a password for your user with `passwd [your username]`
12. Run the command `echo '%wheel ALL=(ALL:ALL) ALL' > /etc/sudoers.d/wheel` to enable give sudo access to all users in the wheel group
13. Run the command `usermod -aG wheel [your username]` to add your user to the wheel group
14. Enable the ssh server systemd service with the command `systemctl enable --now sshd`. It should now start automatically upon boot.
15. From your primary linux machine, run `ssh-copy-id -i [your ssh key] [your linux wii's username]@[your linux wii's IP address]` and enter the password you set in step 11
- `[your ssh key]` is your ssh identity file, likely found in `~/.ssh/`, ending in `.pub`
- `[your linux wii's username]` is the username you set in step 10
- `[your linux wii's IP address]` is the network address of your wii. You can find this by entering the command `ip address show | grep "inet "`
- The address will probably look something like `192.168.1.130`. It will not be the one starting with `127` nor will it be the one ending with `255`
16. Attempt to log in over ssh from your primary linux machine using the command `ssh [your linux wii's username]@[your linux wii's IP address]`
17. Once connected to a shell over ssh, run `sudo whoami` and enter your user password when prompted
- If the output after entering your passwrd is `root` then your user has successfully been given sudo priveleges
- you may now log the wii's `root` user out of any active shells
18. Enable the nginx server systemd service with the command `systemctl enable --now nginx`. It should now start automatically upon boot.
19. Navigate to `http://[your linux wii's IP address]` in a web browser on a device connected to the same network as the Wii. You should be greeted with the nginx splash page.
20. Open the nginx config with `sudo nano /etc/nginx/nginx.conf`. In the `http` block, locate the first `server` block, and change `/usr/share/nginx/html` to `/usr/local/share/nginx/html`
9. Install nginx, sudo, and git using **`pacman -S nginx sudo git`**
10. Create a new non-root user with **`useradd --create-home [your username]`**
11. Set a password for your user with **`passwd [your username]`**
12. Run the command **`echo '%wheel ALL=(ALL:ALL) ALL' > /etc/sudoers.d/wheel`** to enable give sudo access to all users in the wheel group
13. Run the command **`usermod -aG wheel [your username]`** to add your user to the wheel group
14. Enable the ssh server systemd service with the command **`systemctl enable --now sshd`**. It should now start automatically upon boot.
15. From your primary linux machine, run **`ssh-copy-id -i [your ssh key] [your linux wii's username]@[your linux wii's IP address]`** and enter the password you set in step 11
- **`[your ssh key]`** is your ssh identity file, likely found in **`~/.ssh/`**, ending in **`.pub`**
- **`[your linux wii's username]`** is the username you set in step 10
- **`[your linux wii's IP address]`** is the network address of your wii. You can find this by entering the command **`ip address show | grep "inet "`
- The address will probably look something like **`192.168.1.130`**. It will not be the one starting with **`127`** nor will it be the one ending with **`255`**
16. Attempt to log in over ssh from your primary linux machine using the command **`ssh [your linux wii's username]@[your linux wii's IP address]`**
17. Once connected to a shell over ssh, run **`sudo whoami`** and enter your user password when prompted
- If the output after entering your passwrd is **`root`** then your user has successfully been given sudo priveleges
- you may now log the wii's **`root`** user out of any active shells
18. Enable the nginx server systemd service with the command **`systemctl enable --now nginx`**. It should now start automatically upon boot.
19. Navigate to **`http://[your linux wii's IP address]`** in a web browser on a device connected to the same network as the Wii. You should be greeted with the nginx splash page.
20. Open the nginx config with **`sudo nano /etc/nginx/nginx.conf`**. In the **`http`** block, locate the first **`server`** block, and change **`/usr/share/nginx/html`** to **`/usr/local/share/nginx/html`**
21. Press ctrl+x to close the file, press y to confirm saving changes, then press enter to confirm the filename
22. Run the command `sudo mkdir -p /usr/local/share/nginx/html` to create the local nginx resource directory
23. Run the command `sudo systemctl restart nginx` to reload the modified config
24. run the command `echo 'hi' | sudo tee /usr/local/share/nginx/html/index.html` to create a text file at the root of your server.
22. Run the command **`sudo mkdir -p /usr/local/share/nginx/html`** to create the local nginx resource directory
23. Run the command **`sudo systemctl restart nginx`** to reload the modified config
24. run the command **`echo 'hi' | sudo tee /usr/local/share/nginx/html/index.html`** to create a text file at the root of your server.
25. Reload the webpage you navigated to in step 19 and you should see the word 'hi' appear in the browser window.
26. Update the files at `/usr/local/share/nginx/html/` with static web content and it will become available at your wii's IP address
26. Update the files at **`/usr/local/share/nginx/html/`** with static web content and it will become available at your wii's IP address
## Periodically updating the web server's contents (using the config you see here)
27. clone this repository to your user's home directory `cd;git clone 'https://git.pogmom.me/pogmommy/wii-server-setup.git'`
28. cd into the newly-cloned repository and run the setup script `cd wii-server-setup;./setup.sh`. Provide your password when prompted.
27. clone this repository to your user's home directory **`cd;git clone 'https://git.pogmom.me/pogmommy/wii-server-setup.git'`**
28. cd into the newly-cloned repository and run the setup script **`cd wii-server-setup;./setup.sh`**. Provide your password when prompted.
## Finishing touches
XX. Make any remaining configuration changes as desired (change system hostname, etc.)