{"id":22281040,"url":"https://github.com/eclipse-leshan/leshan","last_synced_at":"2025-05-16T04:03:43.554Z","repository":{"id":26956390,"uuid":"30419413","full_name":"eclipse-leshan/leshan","owner":"eclipse-leshan","description":"Java Library for LWM2M","archived":false,"fork":false,"pushed_at":"2025-05-06T16:08:12.000Z","size":13375,"stargazers_count":665,"open_issues_count":66,"forks_count":411,"subscribers_count":68,"default_branch":"master","last_synced_at":"2025-05-06T17:24:50.294Z","etag":null,"topics":["bootstrap-server","coap","device-management","eclipse","eclipseiot","internet-of-things","iot","java","lwm2m","lwm2m-client","lwm2m-protocol","lwm2m-server"],"latest_commit_sha":null,"homepage":"https://www.eclipse.org/leshan/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eclipse-leshan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.BSD-3-Clause","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-02-06T15:44:24.000Z","updated_at":"2025-05-06T16:08:16.000Z","dependencies_parsed_at":"2023-07-28T17:28:59.284Z","dependency_job_id":"c4045987-ec8b-4e89-b7f2-1536723a1ab8","html_url":"https://github.com/eclipse-leshan/leshan","commit_stats":null,"previous_names":["eclipse-leshan/leshan","eclipse/leshan"],"tags_count":60,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-leshan%2Fleshan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-leshan%2Fleshan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-leshan%2Fleshan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-leshan%2Fleshan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eclipse-leshan","download_url":"https://codeload.github.com/eclipse-leshan/leshan/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254464891,"owners_count":22075570,"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":["bootstrap-server","coap","device-management","eclipse","eclipseiot","internet-of-things","iot","java","lwm2m","lwm2m-client","lwm2m-protocol","lwm2m-server"],"created_at":"2024-12-03T16:12:58.561Z","updated_at":"2025-05-16T04:03:43.498Z","avatar_url":"https://github.com/eclipse-leshan.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n\n\u003ca href=\"[https://otterdog.eclipse.org](https://eclipse.dev/leshan/)\"\u003e\n  \u003cimg src=\"https://eclipse.org/leshan/img/multicolor-leshan.png\"\u003e\n\u003c/a\u003e\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://scorecard.dev/viewer/?uri=github.com/eclipse-leshan/leshan\"\u003e\u003cimg alt=\"OpenSSF Scorecard\" src=\"https://api.securityscorecards.dev/projects/github.com/eclipse-leshan/leshan/badge\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://www.bestpractices.dev/projects/10034\"\u003e\u003cimg alt=\"OpenSSF Best Practices\" src=\"https://www.bestpractices.dev/projects/10034/badge\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://sonarcloud.io/summary/new_code?id=eclipse-leshan_leshan\"\u003e\u003cimg alt=\"Quality Gate Status\" src=\"https://sonarcloud.io/api/project_badges/measure?project=eclipse-leshan_leshan\u0026metric=alert_status\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n[Eclipse Leshan™](https://eclipse.dev/leshan/) is an OMA Lightweight M2M server and client Java implementation.\n\n[What is OMA LWM2M ?](https://omaspecworks.org/what-is-oma-specworks/iot/lightweight-m2m-lwm2m/)  \n[LWM2M Specifications](https://github.com/eclipse/leshan/wiki/Lightweight-M2M-Specification).  \n\nLeshan provides libraries which help people to develop their own Lightweight M2M server and client.  \nThe project also provides a client, a server and a bootstrap server demonstration as an example of the Leshan API and for testing purpose.\n\n| LWM2M Version \u003cbr\u003e Targeted | Leshan  \u003cbr\u003e Version | Minimal \u003cbr\u003e Java Version | Development \u003cbr\u003e State |  Build Status   |  Standalone \u003cbr\u003e Demos |\n| - | - | - | - | - | - |\n| [v1.0.x](https://github.com/eclipse/leshan/wiki/Lightweight-M2M-Specification#lightweight-m2m-v10x) | [v1.x](https://github.com/eclipse/leshan/tree/1.x) \u003cbr/\u003e [Supported features](https://github.com/eclipse/leshan/wiki/LWM2M-Supported-features) | Java 7 ([more details](https://github.com/eclipse-leshan/leshan/tree/1.x/documentation/Requirement.md)) | stable released | [jenkins-1.x](https://ci.eclipse.org/leshan/job/leshan-ci/job/1.x/) | [server-demo](https://ci.eclipse.org/leshan/job/leshan-ci/job/1.x/lastSuccessfulBuild/artifact/leshan-demo-server.jar)\u003cbr/\u003e [client-demo](https://ci.eclipse.org/leshan/job/leshan-ci/job/1.x/lastSuccessfulBuild/artifact/leshan-demo-client.jar) \u003cbr/\u003e [bsserver-demo](https://ci.eclipse.org/leshan/job/leshan-ci/job/1.x/lastSuccessfulBuild/artifact/leshan-demo-bsserver.jar) |\n| [**v1.1.x**](https://github.com/eclipse/leshan/wiki/Lightweight-M2M-Specification#lightweight-m2m-v11x)| [**v2.x** (master)](https://github.com/eclipse/leshan/tree/master) \u003cbr/\u003e [Supported features](https://github.com/eclipse/leshan/wiki/LWM2M-1.1-supported-features) | Java 8 ([more details](./documentation/Requirement.md)) | **in development**  |[jenkins-master](https://ci.eclipse.org/leshan/job/leshan-ci/job/master/)     | [server-demo](https://ci.eclipse.org/leshan/job/leshan-ci/job/master/lastSuccessfulBuild/artifact/leshan-demo-server.jar)\u003cbr/\u003e [client-demo](https://ci.eclipse.org/leshan/job/leshan-ci/job/master/lastSuccessfulBuild/artifact/leshan-demo-client.jar) \u003cbr/\u003e [bsserver-demo](https://ci.eclipse.org/leshan/job/leshan-ci/job/master/lastSuccessfulBuild/artifact/leshan-demo-bsserver.jar)  |\n\n\nRelease (stable and milestones) are available on [maven central](https://search.maven.org/search?q=org.eclipse.leshan).  \nNightly build (snapshot) are available on [eclipse repo](https://repo.eclipse.org/#view-repositories;leshan-snapshots~browsestorage). ([more details](https://github.com/eclipse/leshan/pull/885))\n\nThe Leshan Documentation  is available in our [wiki :blue_book:](https://github.com/eclipse/leshan/wiki).\n\nContact\n-------\nIf you have any **questions**, **feedback** or **bugs** to report, please use [github issue](https://github.com/eclipse-leshan/leshan/issues).  \nFor **vulnerabilities**, have a look at our [Security Policy](https://github.com/eclipse-leshan/leshan/security/policy).  \nIf you want to **contribute**, take a look at our [Contribution Guide](https://github.com/eclipse-leshan/leshan/blob/master/CONTRIBUTING.md).\n\n\nWe also have a mail list but it is not so much used :\nJoin the project mailing list : [subscribe](https://dev.eclipse.org/mailman/listinfo/leshan-dev).  \nMail address: leshan-dev@eclipse.org.  \nAccess to [leshan-dev archives](https://dev.eclipse.org/mhonarc/lists/leshan-dev/).  \n\nLicense\n-------\n\nThis work is dual-licensed under the Eclipse Public License v2.0 and Eclipse Distribution License v1.0\n\n`SPDX-License-Identifier: EPL-2.0 OR BSD-3-Clause`\n\nTest Server Sandbox\n------------\n\nYou can try live our servers demos instances:\n\n* The **lwm2m server** at https://leshan.eclipseprojects.io/  \n   _(coap://leshan.eclipseprojects.io:5683  and coaps://leshan.eclipseprojects.io:5684)_  \n* The **bootstrap server** at https://leshan.eclipseprojects.io/bs/  \n   _(coap://leshan.eclipseprojects.io:5783  and coaps://leshan.eclipseprojects.io:5784)_  \n\n(Automatic deployment of master branch)\n\n![Leshan](https://www.eclipse.org/leshan/img/capture_for_github-v2.png)\n\nTest Leshan Demos locally\n-----------------------\nGet and run the last binary of our demo **server** :\n```\nwget https://ci.eclipse.org/leshan/job/leshan-ci/job/master/lastSuccessfulBuild/artifact/leshan-demo-server.jar\njava -jar ./leshan-demo-server.jar\n```\nGet and run the last binary of our demo **client** :\n```\nwget https://ci.eclipse.org/leshan/job/leshan-ci/job/master/lastSuccessfulBuild/artifact/leshan-demo-client.jar\njava -jar ./leshan-demo-client.jar\n```\nGet and run the last binary of our **bootstrap** demo server :\n```\nwget https://ci.eclipse.org/leshan/job/leshan-ci/job/master/lastSuccessfulBuild/artifact/leshan-demo-bsserver.jar\njava -jar ./leshan-demo-bsserver.jar\n```\n:information_source: : _All the demos have a `--help` option._\n\nCompile Leshan \u0026 Run Demos\n-------------\nGet sources :\n```bash\n#using ssh\ngit clone git@github.com:eclipse/leshan.git\n```\nor\n```bash\n#using https\ngit clone https://github.com/eclipse/leshan.git\n\n```\n\nCompile it, by running in leshan root folder :\n\n```\nmvn clean install\n```\n\nRun demo **server**:\n```\njava -jar leshan-demo-server/target/leshan-demo-server-*-SNAPSHOT-jar-with-dependencies.jar \n```\n\nConnect on Leshan demo UI: http://localhost:8080  \nLeshan server Demo provides a very simple UI to get the list of connected clients and interact with clients resources.\n\nNow you can register a LWM2M client by running our **client** demo:\n```\njava -jar leshan-demo-client/target/leshan-demo-client-*-SNAPSHOT-jar-with-dependencies.jar \n```\nor trying the [Eclipse Wakaama](http://eclipse.org/wakaama) test client.\n\nYou can also try our **bootstrap** demo server:\n```\njava -jar leshan-demo-bsserver/target/leshan-demo-bsserver-*-SNAPSHOT-jar-with-dependencies.jar \n```\n\nLet's start to code !\n---------------------\nNow you played a bit with our demo, you should start to code your own server or client using our [Getting-started](https://github.com/eclipse/leshan/wiki/Getting-started) guide.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-leshan%2Fleshan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feclipse-leshan%2Fleshan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-leshan%2Fleshan/lists"}