8.2. Appendix B - Troubleshooting

8.2.1. Rootless Podman Issues

When running Speedgain with an unprivileged user under Podman, ensure the host environment is properly configured.

Symptom / Error Resolution

Error: cannot clone: Invalid argument
or UID/GID mapping errors

The current user lacks subordinate UID/GID allocations. Assign sub-UIDs/GIDs in /etc/subuid and /etc/subgid as described in the Podman Rootless Tutorial.

Containers stop when logging out of SSH
(Monitoring stops unexpectedly)

By default, systemd terminates user sessions upon logout. Enable session lingering for the service user so Speedgain continues monitoring 24/7:
sudo loginctl enable-linger $USER

permission denied connecting to podman.sock

The unprivileged Podman socket is not active. Enable it via systemctl --user enable --now podman.socket and verify that $DOCKER_HOST points to unix://$XDG_RUNTIME_DIR/podman/podman.sock. See the Podman Socket Activation Guide.