Grouparoo PluginsLast Updated: 2021-02-10
Grouparoo can be extended with Plugins to add more Apps, Sources, and Destinations.
The Grouparoo command line tool is used to add a plugin to your project via
grouparoo install [package]. You can learn more about the
grouparoo install command here. So, if you wanted to install the
@grouparoo/mysql plugin, you would run:
grouparoo install @grouparoo/mysql # install the latest version
Please ensure that the versions of your plugins match the version of
@grouparoo/core that you are using exactly in your
package.json file. If you need to install a specific version of a plugin to match
@grouparoo/core, you can:
grouparoo install @email@example.com # install v1.2.3 specifically
While many Grouparoo plugins are available for free via an open-source license, some require a commercial license.
To install a paid plugin, you will need to authenticate to the npm registry to download and install the new package. Grouparoo will provide you with a "npm access token" which will grant you access to the paid Grouparoo plugins you have purchased for your organization. For every computer that needs access to those plugins (developer machine, CI, build server, etc) you will need to provide that token to npm in one of the following ways:
Create a new
.npmrc file in your Grouparoo project. This can be checked into your project and Docker images if kept private. The contents of the file will look like:
//registry.npmjs.org/:_authToken=NPM_TOKEN # ie: //registry.npmjs.org/:_authToken=abc123
You can learn more about using npm access tokens and other ways of storing them from the npm website.
The Grouparoo User Interface (UI) is offered in two separate editions:
@grouparoo/ui-community edition contains everything an engineering team needs to successfully deploy and monitor Grouparoo to sync data. It includes the following features:
- Monitor the application.
- View objects like Properties, Profiles, Groups, etc.
- Trigger runs.
@grouparoo/ui-enterprise edition is everything a company needs to successfully empower all their teams with the data they need. It offers everything in
@grouparoo/ui-community, in addition to:
- Allow non-technical users to configure the Grouparoo server via the web.
- Provide a no-code way to create & manage Properties, Apps, Sources, Schedules, Destinations, Groups, etc.
- Manage permissions and access for users across the organization, including Enterprise login, Team management, etc.
- Do analysis of your data and gain insights.
Note: Please ensure that you are only have one version of the
@grouparoo/ui-* plugins installed, not both.
Being an open-source project, Grouparoo makes it easy to create your own plugins as well! You can learn more from the plugin development docs.