Troubleshooting

You have issues with AppImages in some way? Well, good you found your way to this section. Here, we present solutions to the most common issues you can have when using AppImages.

Note

If you as a user think there are errors within this section or you would like to have some additional problems covered, please do not hesitate to create an issue on GitHub (or ideally send a pull request right away). We’re always open for feedback!

This page is not considered to be exhaustive. For additional help, please see the Contact page.

See also

The basic operation of AppImages is shown on our Quickstart page. This section covers issues which you should only encounter if there’s actual issues with your system, its configuration or with the AppImages themselves.

Contents:

• I get some errors related to something called “FUSE”
  • The AppImage tells me it needs FUSE to run
  • How to install FUSE
  • Fallback (if FUSE can’t be made working)
  • FUSE and Docker
• I have issues with Electron-based AppImages and their sandboxing
  • Check if kernel is configured correctly already
  • Configure unprivileged sandboxes
  • Allow Electron AppImages to run without unprivileged namespaces
  • More information on unprivileged namespaces