Skip to content
probonopd edited this page Nov 2, 2016 · 34 revisions

Welcome to the AppImageKit wiki. Check the right-hand side "Pages" menu to see the wiki pages.

For users

What is an AppImage?

An AppImage is a downloadable file for Linux that contains an application and everything the application needs to run (e.g., libraries, icons, fonts, translations, etc.) that cannot be reasonably expected to be part of each target system.

How do I run an AppImage?

Make it executable and double-click it.

Where can I download AppImages?

See the "repository" of upstream-generated AppImages. If there is no AppImage of your favorite application available, please request it from the author(s) of the application e.g., as a feature request in the issue tracker of the application.

For application developers

There are different ways to generate an AppImage of your application:

  1. Convert existing binary packages. This option might be the easiest if you already have up-to-date packages in place, ideally a ppa for trusty or earlier or a debian repository for oldstable. In this case, you can write a small .yml file and in many cases are done with the package to AppImage conversion. See examples OR
  2. Bundle your Travis CI builds as AppImages. This option might be the easiest if you already have continuous builds on Travis CI in place. In this case, you can write a small scriptfile and in many cases are done with the AppImage generation. See examples OR
  3. Run linuxdeployqt on your Qt application. This option might be the easiest if you have a Qt-based application. In this case, you are probably already using windeployqt and macdeployqt and now can use linuxdeployqt in the same fashion with the -appimage argument and in many cases are done with the AppImage generation See example OR
  4. Use electron-builder. This option might be the easiest if you have an Electron-based application. In this case, you define AppImage as a target for Linux (default in the latest version of electron-builder) and in many cases are done with the AppImage generation. See examples OR
  5. Write your own. Start out with Creating AppImages, then check the examples on bundling certain applications or type of applications as AppImages from the right-hand side "Pages" menu.

For AppImage developers

Curious about AppImage development? Want to contribute? See our list of issues and get in touch with us in #AppImage on irc.freenode.net