Skip to content

Template repository for a creating your own Community App Store for Umbrel. Click "Use this template" and add your apps!

Notifications You must be signed in to change notification settings

getumbrel/umbrel-community-app-store

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Umbrel Community App Store Template

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.

How to use:

  1. Start by clicking the "Use this template" button located above.
  2. Assign an ID and name to your app store within the umbrel-app-store.yml file. 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 is sparkles, and there's an app named hello 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.
  3. Change the name of the sparkles-hello-world folder to match your app's ID. The app ID is for you to decide. For example, if your app store ID is whistles, and your app is named My Video Downloader, you could set its app ID to whistles-my-video-downloader, and rename the folder accordingly.
  4. Next, enter your app's listing details in the whistles-my-video-downloader/umbrel-app.yml. These are displayed in the umbrelOS UI.
  5. Include the necessary Docker services in whistles-my-video-downloader/docker-compose.yml.
  6. 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:
umbrel-0.5.2.mp4

About

Template repository for a creating your own Community App Store for Umbrel. Click "Use this template" and add your apps!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published