Install Canopy¶
No terminal needed. You only add the store once; after that, Canopy's apps show up in Umbrel's App Store next to the official ones.
- In Umbrel, open the App Store, click ⋯ (top right) and choose Community App Stores.
- Paste this address and click Add:
https://github.com/Deepshah0308/canopy-umbrel-store
Troubleshooting¶
| What you see | What to do |
|---|---|
| The app won't open, or shows an error, right after installing | Some apps set up a database the first time and need a minute or two. Wait, then open it again. Still stuck? Right-click the app on your Umbrel home screen and choose Restart. |
| You don't know the app's username or password | Open the app's page in Umbrel's App Store: apps that have their own login show it there. Apps without one sit behind your Umbrel login, so there's nothing extra to type. |
| Umbrel says the port is already in use | Another app on your Umbrel uses the same port. Canopy avoids ports used by Umbrel's official store and the popular community stores, but not every store. Uninstall one of the two, or tell us which app clashes. |
| Canopy's apps don't show up in the App Store | Check the store address is exactly https://github.com/Deepshah0308/canopy-umbrel-store under App Store → ⋯ → Community App Stores, then reload the page. |
| Something else is broken | Right-click the app and choose Troubleshoot to see its logs, then open an issue with what you see. For YAMS, see Troubleshooting YAMS first. |
Updates¶
Canopy checks every app for new releases each morning, tests them, and ships them. Umbrel then shows an Update button on the app, the same as for official apps.
Removing Canopy¶
Uninstall any Canopy apps you no longer want, then in App Store → ⋯ → Community App Stores remove Canopy's address.