GitHub/deck-tailscale
1
0
Fork 0
mirror of https://github.com/tailscale-dev/deck-tailscale.git synced 2025-10-22 07:28:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add instructions to modify /usr after installation, fixes #9

Browse Source
This commit is contained in:
Gus El Khoury Seoane
2023-10-08 20:28:40 +01:00
parent eefbb184e0
commit 798a502763
1 changed files with 21 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
readme.md
View File

@@ -14,6 +14,27 @@ updates.
a login QR code. Scan the code with your phone and authenticate with
Tailscale to bring your Deck onto your network.
### Changing the root filesystem after installing Tailscale
This method for installing Tailscale uses [`systemd` system extensions](https://man.archlinux.org/man/systemd-sysext.8.en)
to install files in the otherwise read-only Steam Deck filesystem. A
side-effect is that the `/usr` and `/opt` directories
(and directories like `/bin`, `/lib`, `/lib64`, `/mnt`, and `/sbin`,
that typically link to `/usr` due to [`/usr` merge](https://www.freedesktop.org/wiki/Software/systemd/TheCaseForTheUsrMerge/)
which SteamOS implements) are read-only while system extensions are active,
*even after running `steamos-readonly disable`*.
If you need to modify files in these directories after installing Tailscale,
run the following commands:
```bash
$ systemd-sysext unmerge
$ steamos-readonly disable
[ make your changes to the rootfs now ]
$ steamos-readonly enable
$ systemd-sysext merge
```
## Updating Tailscale
⚠️ This process will most likely fail if you are accessing the terminal over