{"id":24811093,"url":"https://github.com/thin-edge/c8y-tedge","last_synced_at":"2025-10-13T12:31:40.687Z","repository":{"id":210423648,"uuid":"726442918","full_name":"thin-edge/c8y-tedge","owner":"thin-edge","description":"go-c8y-cli extension for thin-edge.io","archived":false,"fork":false,"pushed_at":"2024-12-03T17:53:34.000Z","size":165,"stargazers_count":0,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T07:44:31.655Z","etag":null,"topics":["go-c8y-cli-extension","thin-edge"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/thin-edge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-02T12:14:56.000Z","updated_at":"2024-11-12T16:39:52.000Z","dependencies_parsed_at":"2024-04-16T15:40:21.028Z","dependency_job_id":"428cea39-88ad-447e-9547-47bbc7d66c91","html_url":"https://github.com/thin-edge/c8y-tedge","commit_stats":null,"previous_names":["reubenmiller/c8y-tedge"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thin-edge%2Fc8y-tedge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thin-edge%2Fc8y-tedge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thin-edge%2Fc8y-tedge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thin-edge%2Fc8y-tedge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thin-edge","download_url":"https://codeload.github.com/thin-edge/c8y-tedge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236345812,"owners_count":19134341,"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":["go-c8y-cli-extension","thin-edge"],"created_at":"2025-01-30T12:19:16.835Z","updated_at":"2025-10-13T12:31:40.683Z","avatar_url":"https://github.com/thin-edge.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# c8y-tedge\n\n[go-c8y-cli](https://goc8ycli.netlify.app/) extension to add some useful command to help manage thin-edge.io with Cumulocity IoT.\n\n## What is included?\n\n**Note**\n\nUse ✅ or 🔲 indicates if the extension includes the given functionality or not.\n\n\n|Type|Included|Notes|\n|----|:-:|-----|\n|Commands|✅|Commands to manage thin-edge.io devices|\n|Views|✅|thin-edge.io specific views|\n\n## Install\n\nThe extension can be installed using the following command.\n\n```sh\nc8y extensions install thin-edge/c8y-tedge\n```\n\nOr if you have it already installed, then update to the latest version using:\n\n```sh\nc8y extensions update tedge\n```\n\n## Examples\n\n### Start a demo container\n\nStart a demo container using a randomly generated device name:\n\n```sh\nc8y tedge demo start\n```\n\nOr you can specify the device name to be used:\n\n```\nc8y tedge demo start tedge0001\n```\n\nOr you can specify the auth-type you want to use (e.g. certificate (default) or basic):\n\n```sh\nc8y tedge demo start tedge0001 --auth-type basic\n\nc8y tedge demo start tedge0001 --auth-type certificate\n```\n\n### Start a tedge-container-bundle container\n\nThe [tedge-container-bundle](https://github.com/thin-edge/tedge-container-bundle) is a lighter weight containerized version of thin-edge.io where it can be used to deploy on devices which are already running a container engine and you don't want to install thin-edge.io on the host.\n\nThe `container-bundle` subcommands provide an easy way to start/stop/list instances of the tedge-container-bundle on your machine so that you can explore the functionality provided by it.\n\nStart a [tedge-container-bundle](https://github.com/thin-edge/tedge-container-bundle) container that can be used to managed other containers. See the project for more details.\n\n```sh\n# Start with an auto generated name\nc8y tedge container-bundle start\n\n# Start and use a given name\nc8y tedge container-bundle start tedge12345\n\n# Start and use basic auth credentials\nc8y tedge container-bundle start tedge12345 --auth-type basic\n\n# Start but don't publish any of the ports on the host\nc8y tedge container-bundle start tedge12345 --no-ports\n\n# Start and publish ports to randomly assigned ports on the host\nc8y tedge container-bundle start tedge12345 --publish-all\n```\n\nThen you can list and then stop the instances using (note: only the instances which were started with the c8y-tedge extension will be shown)\n\n```sh\n# list existing instances\nc8y tedge container-bundle list\n\n# stop / remove an instances\nc8y tedge container-bundle stop tedge12345\n```\n\n### Bootstrap device via ssh\n\nBootstrap a thin-edge.io enable device using SSH.\n\n```sh\nc8y tedge bootstrap root@raspberrypi3-64.local\n```\n\nThe bootstrapping processes does:\n\n* Create the device certificate (if required)\n* Fetch public device certificate and upload it to Cumulocity IoT (private key does not leave the device)\n* Open the device in the Cumulocity IoT Device Management application\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthin-edge%2Fc8y-tedge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthin-edge%2Fc8y-tedge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthin-edge%2Fc8y-tedge/lists"}