Profile
Back to NewsBack
GitHub Trending 9 min
Reader Mode
lissy93/portainer-templates: 🚢 800+ 1-click Portainer app templates

lissy93/portainer-templates: 🚢 800+ 1-click Portainer app templates

14 hours ago
GitHub Trending

Portainer Templates

A compiled list of 500+ ready to go Portainer App templates

🌐 portainer-templates.as93.net

TL;DR Under Settings → App Templates in your Portainer GUI, paste this URL:
https://raw.githubusercontent.com/Lissy93/portainer-templates/main/templates.json

Contents

Intro

In Portainer, App Templates enable you to easily deploy services with a predetermined configuration, while allowing you to customize options through the web UI. While Portainer ships with some default templates (see portainer/templates), it's often helpful to have 1-click access to many more apps + stacks, without having to constantly switch template sources.

This repo combines app templates from several sources, to create a ready-to-go template file containing all the apps you'll ever need. It's also possible to self-host, as well as combine with your own custom templates.

You can browse all supported apps and stacks and see stats, config options and stand-alone installation commands for each, at portainer-templates.as93.net

The template file uses Portainer's v3 format, which is compatible with all Portainer versions. To add a new template, see this guide.

Usage

  1. Log into your Portainer web UI
  2. Under Settings --> App Templates, update the URL to
- https://raw.githubusercontent.com/Lissy93/portainer-templates/main/templates.json
  1. Now under Home --> App Templates, you should see all apps. Click one to deploy.
Show me...

Alternatively, when you start Portainer, you can append the --templates flag pointing to the templates URL.

Self-Hosting

If you'd prefer to source templates locally, you can self-host with Docker - there's a sample NGINX container provided
Just run: docker run -p 8080:80 lissy93/portainer-templates (changing 8080 to a port of your choice)
You'll then be able to pass Portainer the template file located at http://[host]:[port]/templates.json

Or, build locally...

If you'd prefer to build the image yourself locally, you can do so with the following commands (if you're using your own fork, don't forget to switch lissy93 out for your username!)

git clone https://github.com/lissy93/portainer-templates.git
cd portainer-templates
docker build -t portainer-templates .
docker run -d -p "8080:80" portainer-templates

If you're using your own template file, but don't want to fork this repository, you can instead simply pass your templates.json file to the above Docker container as a volume, with -v "${PWD}/templates.json:/usr/share/nginx/html/templates.json"

Editing

The template.json file is generated using the scripts in lib, using GitHub Actions. Running the make command will download all listed sources, parse them, and combine them with anything in the sources dir, outputting the templates.json file.
_So, you only need to edit either the sources.csv file, or add your templates directly into the sources/local/ directory._

Adding a new Source

Every row in sources.csv is name, url, maintainer, kind, where kind is either:
  • collection - somebody's maintained list covering many apps (the default, if you leave it blank)
  • app - a single self-hosted app, published by its own author
Add a row, and the next build downloads it, parses it and merges it into the final template. Because that happens every night, an app author only needs one PR here: from then on they edit the file in their own repo and the change shows up within a day.

If the same app appears more than once, duplicates are settled in this order:

  1. sources/local/ - the copies maintained in this repo
  2. app sources - the author's own template for their own app
  3. collection sources, in the order they're listed in sources.csv
An app source carries exactly one template, so a row approved once can't grow entries nobody reviewed - an author shipping variants adds a row per variant. If an app source stops resolving it's simply left out of that build, whereas a missing collection stops the build, since it would take hundreds of apps with it.

Adding a Template / Template list

Alternatively, place your template file within the sources/local/ directory, and it will be automatically combined into the main template.json. Be sure that your template corresponds to Portainer's App Template JSON Format. Note that anything in there becomes ours to maintain, and needs a PR for every change - so if it's your own app, publishing it from your own repo as an app source is usually the better deal.

Validating Templates

There is a schema defined in Schema.json, which can be used to validate any Portainer template. Run make validate to ensure your template conforms to Portainer's App Template specification. To check a template you host yourself, point the validator straight at its URL with python lib/validate_sources.py .

Maintaining your own Templates

If you'd like to use this repo as a base, but maintain your own list of template, just fork the repository, and update lissy93 with your username in the import URL.

Supported Apps and Stacks


↕️ Click to Expand ↕️


_Click an item, to see stats, config options and installation instructions_

  1. Activepieces -- (Report issues)
  2. Actual -- (Report issues)
  3. Actual Budget: budgets live on your devices, end-to-end encrypted, and this server syncs them. MIT, tiny, beloved - PikaPods features it on their homepage.') -- (Report issues)
  4. Adguard -- (Report issues)
  5. Adguard Home (stack) -- (Report issues)
  6. Adguardhome (container) -- (Report issues)
  7. Adguardhome-sync is a tool to synchronize AdGuardHome config to replica instances." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/adguardhomesync-icon.png" width='26' height='26' /> Adguardhome-sync is a tool to synchronize AdGuardHome config to replica instances.') -- (Report issues)
  8. Agent Box behind basic auth.') -- (Report issues)
  9. AI Marketplace Monitor -- (Report issues)
  10. Airsonic (container) -- (Report issues)
  11. Airsonic (stack) -- (Report issues)
  12. Airsonic-advanced is a free, web-based media streamer, providing ubiquitious access to your music. Use it to share your music with friends, or to listen to your own music while at work. You can stream to multiple players simultaneously, for instance to one player in your kitchen and another in your living room." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/airsonic-banner.png" width='26' height='26' /> Airsonic-advanced is a free, web-based media streamer, providing ubiquitious access to your music. Use it to share your music with friends, or to listen to your own music while at work. You can stream to multiple players simultaneously, for instance to one player in your kitchen and another in your living room.') -- (Report issues)
  13. Alpine Xfce4 noVNC -- (Report issues)
  14. Altus is an Electron-based WhatsApp client with themes and multiple account support." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/altus-logo.png" width='26' height='26' /> Altus is an Electron-based WhatsApp client with themes and multiple account support.') -- (Report issues)
  15. Anchor -- (Report issues)
  16. Ansible-semaphore -- (Report issues)
  17. Anyviz Cloud Adaptor -- (Report issues)
  18. Apache Httpd -- (Report issues)
  19. Apache Kafka with Kafbat UI, deployable locally with plain Docker Compose or to Miget as a compose stack.') -- (Report issues)
  20. Apprise-api Takes advantage of Apprise through your network with a user-friendly API. Send notifications to more than 100 services. An incredibly lightweight gateway to Apprise. A production ready micro-service at your disposal. A Simple Website to verify and test your configuration with. Apprise API was designed to easily fit into existing (and new) eco-systems that are looking for a simple notification solution." src="https://raw.githubusercontent.com/caronc/apprise-api/master/apprise_api/static/logo.png" width='26' height='26' /> Apprise-api (container) Takes advantage of Apprise through your network with a user-friendly API. Send notifications to more than 100 services. An incredibly lightweight gateway to Apprise. A production ready micro-service at your disposal. A Simple Website to verify and test your configuration with. Apprise API was designed to easily fit into existing (and new) eco-systems that are looking for a simple notification solution.') -- (Report issues)
  21. Apprise-API (stack) eco-systems that are looking for a simple notification solution.70+ services Source: https://github.com/caronc/apprise-api') -- (Report issues)
  22. Appsmith is the first open-source low-code tool that helps developers build dashboards and admin panels very quickly.') -- (Report issues)
  23. Appwrite -- (Report issues)
  24. Arcane -- (Report issues)
  25. ArchiSteamFarm -- (Report issues)
  26. Archivebox -- (Report issues)
  27. Ardour is an open source, collaborative effort of a worldwide team including musicians, programmers, and professional recording engineers." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/ardour-logo.png" width='26' height='26' /> Ardour is an open source, collaborative effort of a worldwide team including musicians, programmers, and professional recording engineers.') -- (Report issues)
  28. Aria2 Pro -- (Report issues)
  29. AriaNG -- (Report issues)
  30. Asciinema {shmolf} -- (Report issues)
  31. Atrium
  32. Audacity is an easy-to-use, multi-track audio editor and recorder. Developed by a group of volunteers as open source." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/audacity-logo.png" width='26' height='26' /> Audacity is an easy-to-use, multi-track audio editor and recorder. Developed by a group of volunteers as open source.') -- (Report issues)
  33. Audiobookshelf -- (Report issues)
  34. NeptuneHub/AudioMuse-AI" src="https://raw.githubusercontent.com/NeptuneHub/AudioMuse-AI/main/native-build/linux/packaging/icons/audiomuse-ai_128.png" width='26' height='26' /> AudioMuse-AI')
  35. NeptuneHub/AudioMuse-AI" src="https://raw.githubusercontent.com/NeptuneHub/AudioMuse-AI/main/native-build/linux/packaging/icons/audiomuse-ai_128.png" width='26' height='26' /> AudioMuse-AI (NVIDIA GPU)')
  36. Aurral -- (Report issues)
  37. Authelia for your applications via a web portal.') -- (Report issues)
  38. Authentik -- (Report issues)
  39. Autobrr -- (Report issues)
  40. Azahar is an open-source 3DS emulator based on Citra." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/azahar-logo.png" width='26' height='26' /> Azahar is an open-source 3DS emulator based on Citra.') -- (Report issues)
  41. Azure Pipelines Agent, built from Microsoft’s official Dockerfile recipe - the agent ships no container image, this is the documented path.') -- (Report issues)
  42. Babybuddy is a buddy for babies! Helps caregivers track sleep, feedings, diaper changes, tummy time and more to learn about and predict baby’s needs without (as much) guess work." src="https://github.com/linuxserver/docker-templates/raw/master/linuxserver.io/img/babybuddy-logo.png" width='26' height='26' /> Babybuddy is a buddy for babies! Helps caregivers track sleep, feedings, diaper changes, tummy time and more to learn about and predict baby’s needs without (as much) guess work.') -- (Report issues)
  43. Bagisto -- (Report issues)
  44. Baikal -- (Report issues)
  45. Bambu Studio is an open-source, cutting-edge, feature-rich slicing software. It contains project-based workflows, systematically optimized slicing algorithms, and an easy-to-use graphical interface, bringing users an incredibly smooth printing experience." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/bambustudio-logo.png" width='26' height='26' /> Bambustudio is an open-source, cutting-edge, feature-rich slicing software. It contains project-based workflows, systematically optimized slicing algorithms, and an easy-to-use graphical interface, bringing users an incredibly smooth printing experience.') -- (Report issues)
  46. Baserow (container) -- (Report issues)
  47. Baserow (stack) -- (Report issues)
  48. Bazarr is a companion application to Sonarr and Radarr. It can manage and download subtitles based on your requirements. You define your preferences by TV show or movie and Bazarr takes care of everything for you." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/bazarr.png" width='26' height='26' /> Bazarr (container) is a companion application to Sonarr and Radarr. It can manage and download subtitles based on your requirements. You define your preferences by TV show or movie and Bazarr takes care of everything for you.') -- (Report issues)
  49. Bazarr (stack) -- (Report issues)
  50. Beets is a music library manager and not, for the most part, a music player. It does include a simple player plugin and an experimental Web-based player, but it generally leaves actual sound-reproduction to specialized tools." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/beets-icon.png" width='26' height='26' /> Beets is a music library manager and not, for the most part, a music player. It does include a simple player plugin and an experimental Web-based player, but it generally leaves actual sound-reproduction to specialized tools.') -- (Report issues)
  51. Beszel -- (Report issues)
  52. Bitcoin Knots can be used as a desktop client for regular payments or as a full node server utility for merchants and other payment services." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/bitcoin-knots-logo.png" width='26' height='26' /> Bitcoin-knots can be used as a desktop client for regular payments or as a full node server utility for merchants and other payment services.') -- (Report issues)
  53. Bitwarden RS -- (Report issues)
  54. Wolfenstein: Blade of Agony is a story-driven WWII shooter inspired by Wolfenstein and Doom." src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/boa-logo.png" width='26' height='26' /> Blade-of-agony is a story-driven WWII shooter inspired by Wolfenstein and Doom.') -- (Report issues)
  55. Blender is a free and open-source 3D computer graphics software toolset used for creating animated films, visual effects, art, 3D printed models, motion graphics, interactive 3D applications, virtual reality, and computer games. This image does not support GPU rendering out of the box only accelerated workspace experience" src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/blender-logo.png" width='26' height='26' /> Blender is a free and open-source 3D computer graphics software toolset used for creating animated films, visual effects, art, 3D printed models, motion graphics, interactive 3D applications, virtual reality, and computer games. This image does not support GPU rendering out of the box only accelerated workspace experience') -- (Report issues)
  56. Blinko -- (Report issues)
  57. BOINC is a platform for high-throughput computing on a large scale (thousands or millions of computers). It can be used for volunteer computing (using consumer devices) or grid computing (using organizational resources). It supports virtualized, parallel, and GPU-based applications." src="https://raw.githubusercontent.com/BOINC/boinc/master/doc/logo/boinc_logo_black.jpg" width='26' height='26' /> Boinc is a platform for high-throughput computing on a large scale (thousands or millions of computers). It can be used for volunteer computing (using consumer devices) or grid computing (using organizational resources). It supports virtualized, parallel, and GPU-based applications.') -- (Report issues)
  58. Booksonic -- (Report issues)
  59. Bookstack is a free and open source Wiki designed for creating beautiful documentation. Featuring a simple, but powerful WYSIWYG editor it allows for teams to create detailed and useful documentation with ease. Powered by SQL and including a Markdown editor for those who prefer it, BookStack is geared towards making documentation more of a pleasure than a chore. For more information on BookStack visit their website and check it out: https://www.bookstackapp.com" src="https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/bookstack-logo.png" width='26' height='26' /> Bookstack (container) is a free and open source Wiki designed for creating beautiful documentation. Featuring a simple, but powerful WYSIWYG editor it allows for teams to create detailed and useful documentation with ease. Powered by SQL and including a Markdown editor for those who prefer it, BookStack is geared towards making documentation more of a pleasure than a chore. For more information on BookStack visit their website and check it out: https://www.bookstackapp.com') -- (Report issues)
  60. Bookstack (stack) -- (Report issues)

  61. You finished the article!

    Want to go deeper or explore more stories?

    Full Article on GitHub Trending More Tech News
Reading Mode

Adjust typography and theme to your preference.

View Original
Related Stories
AI agents in a stand-up call
Hacker News 4 hours ago
Satya Nadella says we should assume all AI models are 'compromised'
Hacker News 4 hours ago
GameBoy on E-Paper ESP32 at 30FPS [video]
Hacker News 4 hours ago
CIA World Facebook Is Dead – Here Is an Attempt at Recreation
Hacker News 4 hours ago
500B Tokens Later: Letting AI Agents Decompile a First-Person Shooter
Hacker News 5 hours ago
Related Stories

AI agents in a stand-up call

Hacker News 4 hours ago

Satya Nadella says we should assume all AI models are 'compromised'

Hacker News 4 hours ago

GameBoy on E-Paper ESP32 at 30FPS [video]

Hacker News 4 hours ago

CIA World Facebook Is Dead – Here Is an Attempt at Recreation

Hacker News 4 hours ago

500B Tokens Later: Letting AI Agents Decompile a First-Person Shooter

Hacker News 5 hours ago
Chat with me