Skip to content

Commit 938adc6

Browse files
authored
Merge pull request #12 from gustakasn0v/main
Add instructions to modify /usr after installation, fixes #9
2 parents eefbb18 + 798a502 commit 938adc6

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

readme.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,27 @@ updates.
1414
a login QR code. Scan the code with your phone and authenticate with
1515
Tailscale to bring your Deck onto your network.
1616

17+
### Changing the root filesystem after installing Tailscale
18+
This method for installing Tailscale uses [`systemd` system extensions](https://man.archlinux.org/man/systemd-sysext.8.en)
19+
to install files in the otherwise read-only Steam Deck filesystem. A
20+
side-effect is that the `/usr` and `/opt` directories
21+
(and directories like `/bin`, `/lib`, `/lib64`, `/mnt`, and `/sbin`,
22+
that typically link to `/usr` due to [`/usr` merge](https://www.freedesktop.org/wiki/Software/systemd/TheCaseForTheUsrMerge/)
23+
which SteamOS implements) are read-only while system extensions are active,
24+
*even after running `steamos-readonly disable`*.
25+
26+
If you need to modify files in these directories after installing Tailscale,
27+
run the following commands:
28+
29+
```bash
30+
$ systemd-sysext unmerge
31+
$ steamos-readonly disable
32+
[ make your changes to the rootfs now ]
33+
$ steamos-readonly enable
34+
$ systemd-sysext merge
35+
```
36+
37+
1738
## Updating Tailscale
1839

1940
⚠️ This process will most likely fail if you are accessing the terminal over

0 commit comments

Comments
 (0)