Portainer Templates

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

> **TL;DR** Under Settings → App Templates in your Portainer GUI, paste this URL:
> `https://raw.githubusercontent.com/Lissy93/portainer-templates/main/templates.json`
## Intro In Portainer, [App Templates](https://docs.portainer.io/user/docker/templates) enable you to easily deploy a container with a predetermined configuration, while allowing you to customize options through the web UI. Both single containers, and stacks are supported. While Portainer ships with some default templates (see [portainer/templates](https://github.com/portainer/templates)), it's often helpful to have 1-click access to many more apps, without having to constantly switch template sources. This repo combines app templates from several [sources](#sources), to create a ready-to-go template file containing all the apps you'll ever need. --- ## 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. Alternatively, when you start Portainer, you can append the `--templates` flag pointing to the templates URL. --- ## Self-Hosting ``` 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 ``` Your templates file will then be served up, at: `http://docker-host:8080/templates.json` Or, to mount the `templates.json` file to your container, so that you can make changes to it, and have them show up within Portainer ``` docker run -d -p "8080:80" -v "${PWD}/templates.json:/usr/share/nginx/html/templates.json" portainer-templates ``` --- ## Editing The `template.json` file is generated using the scripts in [`lib`](https://github.com/Lissy93/portainer-templates/tree/main/lib), using GitHub Actions. Running the `make` command will download all listed sources, parse them, and combine them outputting the `templates.json` file. ### 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`](https://github.com/Lissy93/portainer-templates/blob/main/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`](https://github.com/Lissy93/portainer-templates/tree/main/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](https://docs.portainer.io/advanced/app-templates/format). ### Validating Templates There is a schema defined in [`Schema.json`](https://github.com/Lissy93/portainer-templates/blob/main/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](https://docs.portainer.io/advanced/app-templates/format). ### 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. --- ## Sources 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`](https://github.com/Lissy93/portainer-templates/tree/main/sources) directory. - [dnburgess](https://github.com/dnburgess/self-hosted-template) ^{[`template.json`](https://raw.githubusercontent.com/dnburgess/self-hosted-template/master/template.json)} - [qballjos](https://github.com/Qballjos/portainer_templates) ^{[`template.json`](https://raw.githubusercontent.com/Qballjos/portainer_templates/master/Template/template.json)} - [SelfhostedPro](https://github.com/SelfhostedPro/selfhosted_templates) ^{[`template.json`](https://raw.githubusercontent.com/SelfhostedPro/selfhosted_templates/portainer-2.0/Template/template.json)} - [technorabilia](https://github.com/technorabilia/portainer-templates) ^{[`template.json`](https://raw.githubusercontent.com/technorabilia/portainer-templates/main/lsio/templates/templates-2.0.json)} - [mikestraney](https://github.com/mikestraney/portainer-templates) ^{[`template.json`](https://raw.githubusercontent.com/mikestraney/portainer-templates/master/templates.json)} - [xneo1](https://github.com/xneo1/portainer_templates) ^{[`template.json`](https://raw.githubusercontent.com/xneo1/portainer_templates/master/Template/template.json)} --- ## Supported Apps and Stacks --- ## Contributing --- ## Disclaimer --- ## License