From 35de069bf15f1d123adf1ed409000f621ad541ea Mon Sep 17 00:00:00 2001 From: "Josh.5" Date: Mon, 10 Jul 2023 18:04:03 +1200 Subject: [PATCH] Add the start of some troubleshooting docs --- docs/troubleshooting.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 docs/troubleshooting.md diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md new file mode 100644 index 0000000..9557053 --- /dev/null +++ b/docs/troubleshooting.md @@ -0,0 +1,10 @@ +## Flatpaks not working + +Steam runs with Flatpak. These Flatpaks are instlled into the `default` user's home directory so they persist between container updates. Sometimes Flatpaks can get into a knot between major Steam Headless updates. In such cases, it may not work correctly. To fix this, just delete the Flatpak runtime in your `default` user's home directory a restart the container. + +1) Stop the container. +2) Delete the directory `~/.local/share/flatpak` +3) Re-create the container. Don't just restart it. This will trigger an update of the required Flatpak runtimes in the home directory. +4) Reinstall any missing Flatpaks from the Software app. + +Once your Flatpak refresh is complete, everything should work correclty and your configuration for each application should have remained intact. \ No newline at end of file