Guides
Getting started
- Installation
- Server
- Package repository (pacman and APT)
- Child's computer (Linux)
- Child's computer (Windows)
- Settings in the web interface
Operation
- Updates
- Backup and restore
- Data retention
- Switching to PostgreSQL (one-time)
- Uninstalling (child's computer)
- Games (Steam, Heroic)
Security
Games (Steam, Heroic)
On this page
Steam
A child’s Steam library lives under /srv/steam/<child>; ~/.local/share/Steam is only
a link to it. Reason: with app control active, the home folder is noexec, and Steam doesn’t start from the
home folder then. The agent creates the link for every assigned child. It moves an existing
Steam folder in the home folder automatically after the child signs out.
This only works if /home and /srv are on the same file system (with btrfs: on the same
subvolume, so not on CachyOS with @home) and app control is currently off for the child
(the noexec home is a separate mount). Otherwise the web interface reports “…please move manually” under “Integrity”.
Then move it by hand, with the child signed out and Steam closed:
sudo rmdir /srv/steam/<child> # must be empty
sudo mv /home/<child>/.local/share/Steam /srv/steam/<child>
sudo chown -R <child>: /srv/steam/<child> && sudo chmod 700 /srv/steam/<child>
sudo systemctl restart kidctl-agent # creates the link
The folder can be very large; copying between partitions takes correspondingly long.
Heroic (GOG, Epic, Amazon)
Only “Heroic” is allowed. This also allows Electron, the helper programs (gogdl, legendary) and everything
Heroic starts (Wine, Proton, games). As with Steam, the folders from which something is started
live outside the home folder under /srv/heroic/<child>:
| In the home folder (link) | Target |
|---|---|
~/Games/Heroic | /srv/heroic/<child>/Games (games, Wine prefixes) |
~/.config/heroic/tools | /srv/heroic/<child>/tools (Wine, Proton) |
~/.local/share/umu | /srv/heroic/<child>/umu (runtime for Proton) |
~/.cache/heroic_gogdl, ~/.cache/legendary | /srv/heroic/<child>/cache/… (native modules of the GOG and Epic integration) |
The agent moves existing folders after sign-out where possible (same limits as with
Steam), otherwise move them by hand as with Steam (/srv/heroic/<child>/Games or tools as target). The
cache folders of gogdl/legendary are simply deleted and recreated.
If Steam or Heroic is not allowed for a child with app control, the agent mounts its
game folders noexec. Otherwise the child could put their own libraries there and load them into allowed
programs. Once allowed, this is lifted immediately. Don’t change the default installation folder in Heroic: games outside
~/Games/Heroic don’t start with app control active. Amazon games (nile) don’t work
with app control active.
Edit on GitHub · German is the source; please change both languages.