---

Welcome to the AppImage documentation

Willkommen • Welcome • 欢迎 • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Välkommen • أهلا وسهلا • Добро пожаловать • Merhaba • Bonvenon • 歡迎光臨 • خوش آمدید

---

See also

First-time users, heads up! Check out our Quickstart chapter!

In this documentation, all aspects of the AppImage project shall be explained, to have a single unified source of information.

Note

This documentation contains a lot of valuable information, but there’s always something to add. Contributions welcome!

If you are new to AppImage, please read the introduction. It describes the ideas behind AppImage, shows the motivation, explains why you as a user and/or developer should be interested in AppImages. Also, it explains the core concepts of AppImage’s design.

To learn more about using AppImages, please read the User Guide. If you are interested in building and distributing AppImages or building software that works with AppImages, please check the Packaging Guide.

Contents:

• Introduction
  • Quickstart
  • Motivation
  • AppImage advantages
  • Concepts
  • Software Overview
  • A word on upstream packaging
• User Guide
  • Frequently Asked Questions
  • Running AppImages
  • Using portable mode
  • AppImage for macOS switchers
  • Troubleshooting
• Packaging Guide
  • Introduction to Packaging
  • Overview
  • Packaging from source
  • Converting binary packages
  • Optional Resources and Features
  • Hosted services
  • Manual packaging
  • Testing your AppImage
  • Distributing AppImages
  • Environment variables
• Reference
  • Architecture
  • AppImage specification
  • Best practices
  • AppDir specification
  • Desktop integration
• Contact
  • IRC
  • Forum