This repository is a template to create an Umbrel Community App Store. These additional app stores allow developers to distribute applications without submitting to the Official Umbrel App Store.
- Start by clicking the "Use this template" button located above.
- Assign an ID and name to your app store within the
umbrel-app-store.ymlfile. This file specifies two important attributes:id- Acts as a unique prefix for every app within your Community App Store. You must start your application's ID with your app store's ID. For instance, in this template, the app store ID issparkles, and there's an app namedhello world. Consequently, the app's ID should be:sparkles-hello-world.name- This is the name of the Community App Store displayed in the umbrelOS UI.
- Change the name of the
sparkles-hello-worldfolder to match your app's ID. The app ID is for you to decide. For example, if your app store ID iswhistles, and your app is named My Video Downloader, you could set its app ID towhistles-my-video-downloader, and rename the folder accordingly. - Next, enter your app's listing details in the
whistles-my-video-downloader/umbrel-app.yml. These are displayed in the umbrelOS UI. - Include the necessary Docker services in
whistles-my-video-downloader/docker-compose.yml. - That's it! Your Community App Store, featuring your unique app, is now set up and ready to go. To use your Community App Store, you can add its GitHub url the umbrelOS user interface as shown in the following demo: