/portainer-templates

Curated list of services to deploy on a RAK WisGate Developer Gateway using Portainer

Primary LanguageShellMIT LicenseMIT

Portainer template for RAK7391

Introduction

RAK7391 is a flexible IoT platform powered with Raspberry Pi Compute Module 4 which you will be able to tailor to your specific needs. To leverage the potential of RAK7391, we provide a curated list of open source services ready to deploy as containers. These services are host in this repository as a Portainer app template. With Portainer and the app template provided, users can easily deploy the curated containers in minutes.

Any questions or just want something we don't have? Make an issue and we are here to help.

Prerequisites

  1. A host machine with docker installed (recommand to use a Raspberry Pi SBC or compute module and flash the [RAKPiOS image](link to rakpios repo)
  2. A Portainer setup, check the official documentation for instruction on deployment and logging in.

Installing

  1. Browse to Portaine’s setting page, and then go to ”App Template" section

  2. Add the url: https://raw.githubusercontent.com/RAKWireless/portainer-templates/master/portainer_app_template.json , then save settings.

  3. Go to the App Templates in the sidebar, you will see a list of services (as shown in the figure below), choose the service you are interested in, follow the notes and descriptions for each service and option, customize the service to match your own needs, and then hit the button Deploy the container, wait for a few seconds for docker to pull the images and then create services.

Information

  1. Portainer CE didn't add the group-add functionality from docker-compose to container creation until Portainer CE 2.14.0. The curated Node-RED image provided by RAKwireless in the Portainer app template has some issues with usergroup of GPIO, I2C, and USB. To get rid of this issue, please upgrade Portainer-CE's version to at least 2.14.0.

  2. We use Portainer stacks to deploy some of the services. The stacks, as Portainer calls them, are "sets of features that will allow users to start and run your container(s) using a well-structured docker-compose.yml file". For example, a Chirpstack stack definition includes the network server container, the application server container, the gateway bridge container, the MQTT(mosquitto) container, and databases containers (such as posgresql and redis). These stack files share the same syntax with docker-compose YAML file, but with some minor differences. They are stored under the Stack directory.

App List

Copyright and license

Copyright (c) 2022 RAKwireless, under MIT License.