{"id":15290601,"url":"https://github.com/domapic/cloud-domapic-plugin","last_synced_at":"2025-07-06T16:05:11.916Z","repository":{"id":57200666,"uuid":"183928849","full_name":"domapic/cloud-domapic-plugin","owner":"domapic","description":"Plugin for connecting Controllers to Domapic Cloud","archived":false,"fork":false,"pushed_at":"2019-05-02T14:34:18.000Z","size":326,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-14T09:28:03.980Z","etag":null,"topics":["api-key","cloud","domapic","domapic-controller","domapic-plugin","domotic","dynamic-ip","framework","home-automation","iot","iot-platform","jwt","oauth","opensource","plugin","raspberry-pi","remote-control","webhooks"],"latest_commit_sha":null,"homepage":"https://www.domapic.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/domapic.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-28T15:54:42.000Z","updated_at":"2019-05-26T09:25:43.000Z","dependencies_parsed_at":"2022-09-16T15:10:48.288Z","dependency_job_id":null,"html_url":"https://github.com/domapic/cloud-domapic-plugin","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/domapic/cloud-domapic-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domapic%2Fcloud-domapic-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domapic%2Fcloud-domapic-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domapic%2Fcloud-domapic-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domapic%2Fcloud-domapic-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/domapic","download_url":"https://codeload.github.com/domapic/cloud-domapic-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domapic%2Fcloud-domapic-plugin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263932017,"owners_count":23531707,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-key","cloud","domapic","domapic-controller","domapic-plugin","domotic","dynamic-ip","framework","home-automation","iot","iot-platform","jwt","oauth","opensource","plugin","raspberry-pi","remote-control","webhooks"],"created_at":"2024-09-30T16:08:44.759Z","updated_at":"2025-07-06T16:05:11.891Z","avatar_url":"https://github.com/domapic.png","language":"JavaScript","readme":"# Cloud Domapic Plugin\n\n\u003e Domapic Plugin that connects Domapic Controller with [Domapic Cloud service][domapic-cloud-url], making possible to control it remotely through the online app.\n\n[![Build status][travisci-image]][travisci-url] \u003c!--[![Coverage Status][coveralls-image]][coveralls-url] [![Quality Gate][quality-gate-image]][quality-gate-url]--\u003e [![js-standard-style][standard-image]][standard-url]\n\n[![NPM dependencies][npm-dependencies-image]][npm-dependencies-url] [![Last commit][last-commit-image]][last-commit-url] \u003c!--[![Last release][release-image]][release-url] --\u003e\n\n[![NPM downloads][npm-downloads-image]][npm-downloads-url] [![License][license-image]][license-url]\n\n## Intro\n\nThe Cloud Domapic Plugin sends information about your Controller current public IP to the [Domapic Cloud Service][domapic-cloud-url] and maintains it up to date. It also retrieves information about your registered users, allowing them to login through the online app using Google Oauth.\n\nIt does not send passwords or any other sensible information about Controller users. It creates a new api key token for each registered user, and send this one among with the user email. Users can register by their self in the Domapic Cloud Service or sign in using Google Oauth, and then the Controller will appear in their list of authorized Servers. The specific permissions for the user in the Controller will be kept.\n\nOnce your Controller is synced with the Domapic Cloud Service using this plugin, each time you add a new user he will receive an email notification from Domapic Cloud, informing him about how to access.\n\n## Installation\n\n```bash\nnpm i cloud-domapic-plugin -g\n```\n\n## Usage\n\n```bash\ncloud-domapic-plugin start --controller=http://localhost:3000 --controllerApiKey=your-controller-api-key --cloudApiKey=your-cloud.domapic.com-api-key --save\n```\n\nThe plugin will be started in background using [pm2][pm2-url].\n\nTo display logs, type:\n\n```bash\ncloud-domapic-plugin logs #--lines=300\n```\n\n\u003e For further info about all available commands, please read the [domapic service][domapic-service-url] documentation.\n\n## Options\n\nThe plugin, apart of all common [domapic services options][domapic-service-options-url], provides custom options for configuring the connection with Domapic Cloud and your Controller's public url:\n\n* `cloudApiKey` - Domapic Cloud server apiKey. You'll get it when you add your Controller to the Domapic Cloud application.\n* `customPort` - If your Controller is accessed from the internet through a different port than in the local area network, use this option to specify it.\n* `customUrl` - If you have a custom domain for accessing your Controller, you can define here the full url, including port. Is specified, the plugin will send this value instead of the public IP.\n\n\n[coveralls-image]: https://coveralls.io/repos/github/domapic/cloud-domapic-plugin/badge.svg\n[coveralls-url]: https://coveralls.io/github/domapic/cloud-domapic-plugin\n[travisci-image]: https://travis-ci.com/domapic/cloud-domapic-plugin.svg?branch=master\n[travisci-url]: https://travis-ci.com/domapic/cloud-domapic-plugin\n[last-commit-image]: https://img.shields.io/github/last-commit/domapic/cloud-domapic-plugin.svg\n[last-commit-url]: https://github.com/domapic/cloud-domapic-plugin/commits\n[license-image]: https://img.shields.io/npm/l/cloud-domapic-plugin.svg\n[license-url]: https://github.com/domapic/cloud-domapic-plugin/blob/master/LICENSE\n[npm-downloads-image]: https://img.shields.io/npm/dm/cloud-domapic-plugin.svg\n[npm-downloads-url]: https://www.npmjs.com/package/cloud-domapic-plugin\n[npm-dependencies-image]: https://img.shields.io/david/domapic/cloud-domapic-plugin.svg\n[npm-dependencies-url]: https://david-dm.org/domapic/cloud-domapic-plugin\n[quality-gate-image]: https://sonarcloud.io/api/project_badges/measure?project=cloud-domapic-plugin\u0026metric=alert_status\n[quality-gate-url]: https://sonarcloud.io/dashboard?id=cloud-domapic-plugin\n[release-image]: https://img.shields.io/github/release-date/domapic/cloud-domapic-plugin.svg\n[release-url]: https://github.com/domapic/cloud-domapic-plugin/releases\n[standard-image]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg\n[standard-url]: http://standardjs.com/\n\n[domapic-cloud-url]: https://cloud.domapic.com/\n[domapic-service-options-url]: https://github.com/domapic/domapic-service#options\n[domapic-service-url]: https://github.com/domapic/domapic-service\n[pm2-url]: http://pm2.keymetrics.io/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomapic%2Fcloud-domapic-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdomapic%2Fcloud-domapic-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomapic%2Fcloud-domapic-plugin/lists"}