https://github.com/getumbrel/umbrel-community-app-store

Template repository for a creating your own Community App Store for Umbrel. Click "Use this template" and add your apps!
https://github.com/getumbrel/umbrel-community-app-store

Last synced: about 1 month ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/getumbrel/umbrel-community-app-store
• Owner: getumbrel
• Created: 2022-09-25T17:24:51.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2024-04-08T20:56:35.000Z (5 months ago)
• Last Synced: 2024-04-28T06:13:03.622Z (5 months ago)
• Homepage:
• Size: 6.84 KB
• Stars: 46
• Watchers: 5
• Forks: 48
• Open Issues: 7
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
## 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](https://github.com/getumbrel/umbrel-apps).

## 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:

https://user-images.githubusercontent.com/10330103/197889452-e5cd7e96-3233-4a09-b475-94b754adc7a3.mp4