Skip to content

Commit 73a5e98

Browse files
authored
Merge pull request #3721 from sandstorm-io/ubuntu2404-fix-docs
2 parents 999aab5 + 2959004 commit 73a5e98

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

docs/administering/install-troubleshooting.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,21 @@ sudo service sandstorm restart
129129

130130
This should resolve your problems. If not, please get in touch.
131131

132+
## Are grains not starting on Ubuntu 24.04 or later?
133+
134+
If your wildcard DNS is configured correctly, you should see the app icons correctly on the apps tab. If
135+
grains are not starting, and you are on Ubuntu 24.04 or later, AppArmor may be restricting unprivileged
136+
user namespaces. You can run the following commands to correct this:
137+
138+
```bash
139+
sudo sh -c 'echo "kernel.apparmor_restrict_unprivileged_userns = 0" > /etc/sysctl.d/sandstorm-userns.conf'
140+
sudo sysctl --system
141+
sudo service sandstorm restart
142+
```
143+
144+
As of this writing, this restriction is very uncommon in Linux distributions, but you may wish to consult
145+
updated guidance. An AppArmor profile for Sandstorm would be a welcome contribution.
146+
132147
## Did you disable outside collaborators before attempting to configure Google or GitHub login methods?
133148

134149
The setting "Disallow collaboration with users outside the organization" is intended for servers using

0 commit comments

Comments
 (0)