/portainer-templates

🚢 400+ 1-click Portainer app templates

Primary LanguagePythonMIT LicenseMIT

Portainer Templates

A compiled list of 400+ 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

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
  3. 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

Alternatively, you can build the image yourself locally, 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 portainer-templates
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/ directory.

Adding a new Source

If you're maintaining your own list of Portainer templates, and would like them to be included, just add the URL to your template.json file to sources.csv, along with a name. When the action runs, it will download the content, parse it and add it to the final template.

Adding a Template / Template list

Alternatively, place your template file within the sources 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.

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.

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. Actual
  2. Adguard
  3. Adguardhome
  4. Adguardhome-Sync
  5. Airsonic
  6. Airsonic-Advanced
  7. Alpine Xfce4 Novnc
  8. Apache Httpd
  9. Apprise-Api
  10. Appsmith
  11. Appwrite
  12. Archisteamfarm
  13. Archivebox
  14. Aria2 Pro
  15. Ariang
  16. Audacity
  17. Audiobookshelf
  18. Authelia
  19. Authentik
  20. Autobrr
  21. Babybuddy
  22. Baikal
  23. Baserow
  24. Bazarr
  25. Beets
  26. Bitwarden Rs
  27. Blender
  28. Boinc
  29. Booksonic
  30. Booksonic-Air
  31. Bookstack
  32. Broadlink Manager
  33. Budge
  34. Budibase
  35. Caddy
  36. Calibre
  37. Calibre Web
  38. Cardigann
  39. Castopod
  40. Changedetection
  41. Changedetection.Io
  42. Chevereto
  43. Chiefonboarding
  44. Chowdown
  45. Chromium
  46. Chrony Ntp
  47. Ci
  48. Clamav
  49. Cloud Commander
  50. Cloud9
  51. Cloudflare Ddns
  52. Cockroachdb
  53. Code Server
  54. Codex
  55. Codiad
  56. Commandbox
  57. Contentbox
  58. Cops
  59. Couchpotato
  60. Cratedb
  61. Cryptofolio
  62. Daapd
  63. Darktable
  64. Dashdot
  65. Dashmachine
  66. Dashy
  67. Datadog Agent
  68. Davinci Postgres Server
  69. Davos
  70. Ddclient
  71. Deemix
  72. Deluge
  73. Deluge Openvpn
  74. Digikam
  75. Dillinger
  76. Diskover
  77. Docker Container Stats
  78. Docker-Compose
  79. Documize
  80. Dokku
  81. Dokuwiki
  82. Domoticz
  83. Doplarr
  84. Doublecommander
  85. Dozzle
  86. Dradis
  87. Draw.Io
  88. Droppy
  89. Drupal
  90. Duck Dns
  91. Duplicacy
  92. Duplicati
  93. Eclipse Mosquitto
  94. Eclipse Mosquitto Mqtt
  95. Edgeconnector 840D
  96. Edgeconnector Modbus
  97. Elasticsearch
  98. Emby
  99. Embystat
  100. Emulatorjs
  101. Endlessh
  102. Eufy Security Ws
  103. Excalidraw
  104. Fail2Ban
  105. Fdo
  106. Feed2Toot
  107. Fenrus
  108. Ferdi Server
  109. Ferdium
  110. Ffmpeg
  111. Filebrowser
  112. Filebrowser Latest
  113. Filebrowser S6
  114. Filepizza
  115. Filerun
  116. Filestash
  117. Filezilla
  118. Firefox
  119. Fireshare
  120. Flame
  121. Flame-Dashboard
  122. Flaresolverr
  123. Fleet
  124. Floating License Server
  125. Flood
  126. Foldingathome
  127. Foundryvtt Server
  128. Freeboard
  129. Freescout
  130. Freshrss
  131. Frigate Nvr
  132. Gaps
  133. Gazee
  134. Ghost
  135. Ghostfolio
  136. Gitea
  137. Gitea With Mariadb
  138. Github-Desktop
  139. Gitlab Ce
  140. Gitqlient
  141. Glances
  142. Go-Socks5-Proxy
  143. Gokapi
  144. Gotify
  145. Grafana
  146. Grav
  147. Grocy
  148. Guacamole
  149. Guacd
  150. Habridge
  151. Hasty-Paste
  152. Headphones
  153. Healthchecks
  154. Hedgedoc
  155. Heimdall
  156. Homarr
  157. Homarr-Secured
  158. Home Assistant
  159. Homebridge
  160. Homebridge - Debian
  161. Homechart
  162. Homepage
  163. Homer
  164. Htpc Manager
  165. Httpd
  166. Huginn
  167. Hydra2
  168. I Hate Money
  169. Immich
  170. Influxdb
  171. Influxdb & Telegraf
  172. Influxdb 1.8.10
  173. Invoice Ninja
  174. Iobroker
  175. Iperf
  176. Ipfs
  177. Ironfunctions
  178. Ironfunctions Api
  179. Ironfunctions Ui
  180. Jackett
  181. Jdownloader
  182. Jellyfin
  183. Jellyfin-Accounts
  184. Jellyseer
  185. Jellyseerr
  186. Jenkins
  187. Jenkins-Builder
  188. Joomla
  189. Joplin
  190. Jump
  191. Kanzi
  192. Kasm
  193. Kavita
  194. Kdenlive
  195. Klaxon
  196. Klipper[Testing], Mainsail, Moonraker
  197. Kodi Headless
  198. Koillection
  199. Komga
  200. Lazylibrarian
  201. Lazytainer
  202. Ldap-Auth
  203. Leantime
  204. Let'S Encrypt
  205. Let'S Encrypt / Swag
  206. Let'S Encrypt [Deprecated]
  207. Libreddit
  208. Libreoffice
  209. Libresonic
  210. Librespeed
  211. Lidarr
  212. Limnoria
  213. Littlelink Server
  214. Liveswitch
  215. Lldap
  216. Logzio Logs Collector
  217. Logzio Metrics Collector
  218. Lollypop
  219. Lychee
  220. Lychee With Mariadb
  221. Magento 2
  222. Magicmirror2
  223. Mailpile
  224. Maloja
  225. Mariadb
  226. Mastodon
  227. Matomo
  228. Mautic
  229. Mayan Edms
  230. Mcmyadmin 2
  231. Mealie
  232. Medusa
  233. Meilisearch
  234. Meshcentral
  235. Metube
  236. Microsoft Oms Agent
  237. Midarr
  238. Minecraft Server
  239. Minetest
  240. Miniflux
  241. Minio
  242. Minisatip
  243. Mongo
  244. Monica
  245. Moodle
  246. Mozilla Syncserver
  247. Mstream
  248. Mullvad-Browser
  249. Murmur
  250. Musicbrainz
  251. Muximux
  252. Mylar
  253. Mylar3
  254. Mysql
  255. Mysql-Workbench
  256. N8N
  257. Nano
  258. Nano-Wallet
  259. Navidrome
  260. Neko
  261. Netbootxyz
  262. Netbox
  263. Netdata
  264. Nextcloud
  265. Nextcloudpi
  266. Nextcloudstack
  267. Nginx
  268. Nginx Proxy Manager
  269. Nginx Proxy Manager V2 With Mysql [Deprecated]
  270. Nginx Proxy Manager V2 With Mysql And Goaccess Charts [Deprecated]
  271. Nginx Proxy Manager V2 With Sqlite And Goaccess Charts
  272. Nginx Proxy Manager V2 With Sqllite
  273. Nginx Proxy Manager V3 [Devel] Not Ready For Use
  274. Ngircd
  275. Nitter
  276. Nntp2Nntp
  277. Nocodb
  278. Node Red
  279. Nodejs
  280. Nord-Vpn
  281. Nut Server
  282. Nuts
  283. Nzbget
  284. Nzbhydra 2
  285. Octoprint
  286. Odoo
  287. Omada Eap Controller
  288. Ombi
  289. Opc Router
  290. Openamt
  291. Openbudgeteer
  292. Openfaas
  293. Openssh-Server
  294. Openvpn Access Server
  295. Openvpn-As
  296. Openvscode-Server
  297. Opera
  298. Organizr
  299. Organizr V2
  300. Ory Kratos (Oathkeeper)
  301. Ory Kratos (Standalone)
  302. Oscam
  303. Outline
  304. Overseerr
  305. Owncloud
  306. Pairdrop
  307. Paperless
  308. Paperless Ngx
  309. Paperless-Ng
  310. Papermerge
  311. Peppermint
  312. Petio
  313. Pgadmin
  314. Photoprism
  315. Photoshow
  316. Phpmyadmin
  317. Pi-Hole
  318. Pi-Hole Doh/Dot
  319. Pi-Hole-Unbound
  320. Pi.Alert
  321. Pidgin
  322. Piwigo
  323. Pixapop
  324. Pixel-Server
  325. Plesk
  326. Plex
  327. Plex Media Server
  328. Plex Requests
  329. Plex-Meta-Manager
  330. Plone
  331. Portainer Agent
  332. Poste.Io
  333. Postgresql
  334. Pritunl
  335. Privatebin
  336. Projectsend
  337. Protonmail Bridge
  338. Prowlarr
  339. Proxitok
  340. Pure-Ftp Server
  341. Pwndrop
  342. Pydio
  343. Pydio-Cells
  344. Pyload-Ng
  345. Pylon
  346. Qbittorrent
  347. Qdirstat
  348. Qflood
  349. Quassel Irc
  350. Quassel-Core
  351. Quassel-Web
  352. Rabbitmq
  353. Radarr
  354. Raneto
  355. Raspberry Pi Docker Monitor
  356. Rclone Config Backup
  357. Rdesktop
  358. Reactive-Resume
  359. Readarr
  360. Readme-Sync
  361. Redis
  362. Redis Cluster
  363. Redmine
  364. Registry
  365. Registry (Cache)
  366. Remmina
  367. Remotely
  368. Requestrr
  369. Resilio Sync
  370. Reveal.Js
  371. Rocket Chat
  372. Rport
  373. Rsnapshot
  374. Rustdesk
  375. Rutorrent
  376. Sabnzbd
  377. Samba
  378. Scality S3
  379. Scrutiny
  380. Searxng
  381. Sematext Docker Agent
  382. Servas
  383. Shiori
  384. Sickchill
  385. Sickgear
  386. Sickrage
  387. Signal Proxy
  388. Silverstripe
  389. Smokeping
  390. Snapdrop
  391. Snibox
  392. Snipe-It
  393. Snippet-Box
  394. Softing Edgeconnector Modbus
  395. Solr
  396. Sonarr
  397. Speedtest Tracker
  398. Sql Server
  399. Sql Server Express
  400. Sqlitebrowser
  401. Sshwifty
  402. Stash
  403. Statping
  404. Surrealdb
  405. Swag
  406. Swag - Secure Web Application Gateway
  407. Synclounge
  408. Syncthing
  409. Syslog-Ng
  410. System Stats Oled Display
  411. Tabby
  412. Tailscale
  413. Taisun
  414. Tandoor
  415. Tautulli
  416. Tdarr
  417. Teleport
  418. Tester
  419. Thelounge
  420. Tiddlywiki
  421. Tiny Tiny Rss
  422. Tooljet
  423. Tosibox Lock For Container
  424. Traefik
  425. Traggo
  426. Transmission
  427. Transmission Openvpn Version 4
  428. Transmission-Openvpn
  429. Trilium
  430. Trudesk
  431. Tvheadend
  432. Ubooquity
  433. Ubuntu
  434. Umami.Is
  435. Unifi Controller
  436. Unifi Video
  437. Unmanic
  438. Unpoller Monitor
  439. Upsnap
  440. Uptime Kuma
  441. Urbackup
  442. Urlwatch
  443. Vaultwarden
  444. Vikunja
  445. Vikunja With Frontend
  446. Vlmcsd - Kms
  447. Vscodium
  448. Vsftpd Ftp Server
  449. Wallabag
  450. Watchtower
  451. Webcord
  452. Webgrab+Plus
  453. Webtop
  454. Wger
  455. Whisparr
  456. Whoogle
  457. Wikijs
  458. Windows 2000
  459. Wireguard
  460. Wireguard Server
  461. Wireshark
  462. Wizarr
  463. Wordpress
  464. Wowza
  465. Wps-Office
  466. Xbackbone
  467. Xwiki
  468. Yacht
  469. Your-Spotify
  470. Yourls
  471. Youtubedl-Material
  472. Yq
  473. Znc
  474. Zus.Am

Sources


↕️ Click to Expand ↕️

Full credit to the authors of the following templates. The main templates.json file is composes of these sources, along with the content of the sources directory.

  1. template by @dnburgess
  2. template by @Qballjos
  3. template by @SelfhostedPro
  4. template by @technorabilia
  5. template by @mikestraney
  6. template by @xneo1
  7. template by @novaspirit
  8. template by @donpablonow
  9. template by @mediadepot
  10. template by @mycroftwilde
  11. template by @mediadepot
  12. template by @portainer

Contributing

Contributions of any kind are very welcome, and would be much appreciated. For Code of Conduct, see Contributor Convent.

For a guide on adding templates, see the Editing section above (TLDR; either update sources.csv, or paste your template collection into the ./sources directory). Or, to make changes to the website, see the Website section below.

If you're new to GitHub, you can get started by forking the repo, making your changes, adding, commiting and pushing the code, then come back here to open a pull request. You may also find this guide or the git docs helpful for getting started, but feel free to reach out if you need any support.

Website

There's a simple website, which lists all available templates and shows stats, config options and installation instructions for each app / stack. You can view it at portainer-templates.netlify.app

The source is located in the website branch, and it's build as a simple SSR Svelte app (using SvelteKit + TypeScript + SCSS + Vite). To make changes to the website, you'll need Node.js and Git installed. Then just run the following commands:

git clone -b website git@github.com:Lissy93/portainer-templates.git # Clone the website branch
cd portainer-templates # Navigate into the directory
npm i # Install dependencies
npm run dev # Start the development server

And to pubish, run npm run build then either use npm start or host the content of the '/build' directory using a web server of your choice. Alternatively, there's a Dockerfile, for easy deployment :)

Note that it's not required to make any changes to the website when adding a new template or templates source, as data is fetched directly from templates.json in the repo's main branch - so should show up automatically once your changes are merged.

Mirror

There's a mirror of this repository, maintained on CodeBerg at: codeberg.org/alicia/portainer-templates

To pull templates from there, instead of GitHub, use this URL in your Portainer instance instead:

https://codeberg.org/alicia/portainer-templates/raw/branch/main/templates.json

License

Note For licenses for each app listed here, see their websites (linked to above).

Lissy93/Portainer-Templates is licensed under MIT © Alicia Sykes 2023.
For information, see TLDR Legal > MIT

Expand License 
The MIT License (MIT)
Copyright (c) Alicia Sykes <alicia@omg.com> 

Permission is hereby granted, free of charge, to any person obtaining a copy 
of this software and associated documentation files (the "Software"), to deal 
in the Software without restriction, including without limitation the rights 
to use, copy, modify, merge, publish, distribute, sub-license, and/or sell 
copies of the Software, and to permit persons to whom the Software is furnished 
to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included install 
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANT ABILITY, FITNESS FOR A
PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

© Alicia Sykes 2023
Licensed under MIT

Thanks for visiting :)