by eclipse

eclipse /leshan

Eclipse Leshan is an OMA Lightweight M2M (LWM2M) implementation in Java.

436 Stars 299 Forks Last release: 2 months ago (leshan-1.1.0) Eclipse Public License 2.0 1.2K Commits 34 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Eclipse Leshan™ is an OMA Lightweight M2M server and client Java implementation.

What is OMA LWM2M ?
Object and Resource Registry.

Leshan provides libraries which help people to develop their own Lightweight M2M server and client.
The project also provides a client, a server and a bootstrap server demonstration as an example of the Leshan API and for testing purpose.

| LWM2M Version Targeted | Leshan Version | Development State | Build Status | Standalone Demos | | - | - | - | - | - | | v1.0.2
core specification(pdf) | v1.x
Supported features | stable released | jenkins-1.x | server-demo
bsserver-demo | | v1.1.1
core specification(html)
transport bindings(html)| v2.x (master)
Supported features | in development |jenkins-master | server-demo
bsserver-demo |

The Leshan Documentation is available in our wiki :blue_book:.


Join the project mailing list : subscribe.
Mail address: [email protected]
Access to leshan-dev archives.

Test Server Sandbox

You can try live our servers demos instances:

  • The lwm2m server at https://leshan.eclipseprojects.io/
    (coap://leshan.eclipseprojects.io:5683 and coaps://leshan.eclipseprojects.io:5684)
  • The bootstrap server at https://leshan.eclipseprojects.io/bs/
    (coap://leshan.eclipseprojects.io:5783 and coaps://leshan.eclipseprojects.io:5784)

(Automatic deployment of master branch)


Test Leshan Demos locally

Get and run the last binary of our demo server :

wget https://ci.eclipse.org/leshan/job/leshan/lastSuccessfulBuild/artifact/leshan-server-demo.jar
java -jar ./leshan-server-demo.jar
Get and run the last binary of our demo client :
wget https://ci.eclipse.org/leshan/job/leshan/lastSuccessfulBuild/artifact/leshan-client-demo.jar
java -jar ./leshan-client-demo.jar
Get and run the last binary of our bootstrap demo server :
wget https://ci.eclipse.org/leshan/job/leshan/lastSuccessfulBuild/artifact/leshan-bsserver-demo.jar
java -jar ./leshan-bsserver-demo.jar
:informationsource: : _All the demos have a

Compile Leshan & Run Demos

Get sources : ```bash

using ssh

git clone [email protected]:eclipse/leshan.git


using https

git clone https://github.com/eclipse/leshan.git

Compile it, by running in leshan root folder :

mvn clean install ```

Run demo server:

java -jar leshan-server-demo/target/leshan-server-demo-*-SNAPSHOT-jar-with-dependencies.jar 

Connect on Leshan demo UI: http://localhost:8080
Leshan server Demo provides a very simple UI to get the list of connected clients and interact with clients resources.

Now you can register a LWM2M client by running our client demo:

java -jar leshan-client-demo/target/leshan-client-demo-*-SNAPSHOT-jar-with-dependencies.jar 
or trying the Eclipse Wakaama test client.

You can also try our bootstrap demo server:

java -jar leshan-bsserver-demo/target/leshan-bsserver-demo-*-SNAPSHOT-jar-with-dependencies.jar 

Let's start to code !

Now you played a bit with our demo, you should start to code your own server or client using our Getting-started guide.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.