{"_id":"57759493d44a3e0e00329c75","project":"5764745b4f867c0e002bc8ed","version":{"_id":"5764745b4f867c0e002bc8f0","project":"5764745b4f867c0e002bc8ed","__v":4,"createdAt":"2016-06-17T22:06:19.667Z","releaseDate":"2016-06-17T22:06:19.667Z","categories":["5764745b4f867c0e002bc8f1","57683255bb15f40e00a288ce","57683306d8067e1900fc823d","57694b8f47693a0e00002b19"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"57683306d8067e1900fc823d","__v":0,"project":"5764745b4f867c0e002bc8ed","version":"5764745b4f867c0e002bc8f0","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-06-20T18:16:38.236Z","from_sync":false,"order":3,"slug":"development","title":"Development"},"user":"5564f227f0f70f0d00a9ab20","__v":1,"githubsync":"","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-30T21:52:19.257Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":999,"body":"Would you like to have your own list of devices appear in app.octoblu.com and connector-factory.octoblu.com? You can easily add one that acts just like [Official Octoblu Connectors Registry](https://github.com/octoblu/meshblu-connector-official-registry) by hosting your own JSON file with the following structure:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"name\\\": \\\"My Custom Registry\\\",\\n  \\\"documentation\\\": \\\"...\\\",\\n  \\\"version\\\": \\\"1.0.0\\\",\\n  \\\"items\\\": [\\n    {\\n      \\\"_id\\\": \\\"someuser-meshblu-connector-custom-device\\\",\\n      \\\"name\\\": \\\"My Custom Device\\\",\\n      \\\"description\\\": \\\"blah blah blah\\\",\\n      \\\"type\\\": \\\"device:my-custom-device\\\",\\n      \\\"tags\\\": [\\\"Awesome Thing\\\"],\\n      \\\"githubSlug\\\": \\\"someuser/meshblu-connector-custom-device\\\",\\n      \\\"createUri\\\": \\\"https://connector-factory.octoblu.com/connectors/create/someuser/meshblu-connector-custom-device\\\",\\n      \\\"configureUri\\\": \\\"https://connector-factory.octoblu.com/things/configure/:uuid\\\",\\n      \\\"iconUri\\\": \\\"https://icons.octoblu.com/devices/generic.svg\\\"\\n    }\\n  ]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nOnce you have a hosted registry, now update your Octoblu User with the registry uri. You can use [meshblu-util](https://github.com/octoblu/meshblu-util) to do this.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"# Install meshblu-util\\nnpm install -g meshblu-util\\n\\n# Go to tmp directory\\ncd /path/to/some/tmp/dir\\n\\n# Create a meshblu.json of your Octoblu User\\nmeshblu-util register > meshblu.json\\n\\n# Copy the UUID and generate a token for your Octoblu user (https://app.octoblu.com/profile)\\n# Add them to your meshblu.json\\nvim meshblu.json\\n\\n# Create an update json file\\n# Write the following to the following custom-registry-update.json\\n# {\\n#  \\\"$set\\\": {\\n#    \\\"octoblu.registries.connectors.my-custom-registry.uri\\\": \\\"[url-to-my-custom-registry]\\\"\\n#  }\\n# }\\n\\nmeshblu-util update -p -f ./custom-registry-update.json\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"custom-registry","type":"basic","title":"Custom Registry"}
Would you like to have your own list of devices appear in app.octoblu.com and connector-factory.octoblu.com? You can easily add one that acts just like [Official Octoblu Connectors Registry](https://github.com/octoblu/meshblu-connector-official-registry) by hosting your own JSON file with the following structure: [block:code] { "codes": [ { "code": "{\n \"name\": \"My Custom Registry\",\n \"documentation\": \"...\",\n \"version\": \"1.0.0\",\n \"items\": [\n {\n \"_id\": \"someuser-meshblu-connector-custom-device\",\n \"name\": \"My Custom Device\",\n \"description\": \"blah blah blah\",\n \"type\": \"device:my-custom-device\",\n \"tags\": [\"Awesome Thing\"],\n \"githubSlug\": \"someuser/meshblu-connector-custom-device\",\n \"createUri\": \"https://connector-factory.octoblu.com/connectors/create/someuser/meshblu-connector-custom-device\",\n \"configureUri\": \"https://connector-factory.octoblu.com/things/configure/:uuid\",\n \"iconUri\": \"https://icons.octoblu.com/devices/generic.svg\"\n }\n ]\n}", "language": "json" } ] } [/block] Once you have a hosted registry, now update your Octoblu User with the registry uri. You can use [meshblu-util](https://github.com/octoblu/meshblu-util) to do this. [block:code] { "codes": [ { "code": "# Install meshblu-util\nnpm install -g meshblu-util\n\n# Go to tmp directory\ncd /path/to/some/tmp/dir\n\n# Create a meshblu.json of your Octoblu User\nmeshblu-util register > meshblu.json\n\n# Copy the UUID and generate a token for your Octoblu user (https://app.octoblu.com/profile)\n# Add them to your meshblu.json\nvim meshblu.json\n\n# Create an update json file\n# Write the following to the following custom-registry-update.json\n# {\n# \"$set\": {\n# \"octoblu.registries.connectors.my-custom-registry.uri\": \"[url-to-my-custom-registry]\"\n# }\n# }\n\nmeshblu-util update -p -f ./custom-registry-update.json", "language": "shell" } ] } [/block]