Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eclipse-ditto/ditto
Eclipse Ditto™: Digital Twin framework of Eclipse IoT - main repository
https://github.com/eclipse-ditto/ditto
akka digital-shadow digital-twin digital-twins ditto eclipse-ditto eclipseiot hacktoberfest internet-of-things iot java javascript mongodb w3c web-of-things wot
Last synced: 7 days ago
JSON representation
Eclipse Ditto™: Digital Twin framework of Eclipse IoT - main repository
- Host: GitHub
- URL: https://github.com/eclipse-ditto/ditto
- Owner: eclipse-ditto
- License: epl-2.0
- Created: 2017-04-10T19:29:57.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-12-04T07:12:05.000Z (2 months ago)
- Last Synced: 2024-12-11T07:11:54.740Z (about 2 months ago)
- Topics: akka, digital-shadow, digital-twin, digital-twins, ditto, eclipse-ditto, eclipseiot, hacktoberfest, internet-of-things, iot, java, javascript, mongodb, w3c, web-of-things, wot
- Language: Java
- Homepage: https://eclipse.dev/ditto/
- Size: 144 MB
- Stars: 699
- Watchers: 35
- Forks: 230
- Open Issues: 82
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-edge - Eclipse Ditto - the open-source project of Eclipse IoT that provides a ready-to-use functionality to manage the state of Digital Twins (_Table of Contents_ / _Projects in the curated list are filtered based on the following conditions:_)
README
# Eclipse Ditto™
[](https://gitter.im/eclipse/ditto?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://github.com/eclipse-ditto/ditto/actions/workflows/maven.yml?query=workflow%3Abuild)
[](https://search.maven.org/search?q=g:org.eclipse.ditto)
[](https://hub.docker.com/search?q=eclipse%2Fditto&type=image)
[](https://opensource.org/licenses/EPL-2.0)
[](https://www.openhub.net/p/eclipse-ditto)
[Eclipse Ditto](https://www.eclipse.dev/ditto/)™ is a technology in the IoT implementing a software pattern called “digital twins”.
A digital twin is a virtual, cloud based, representation of his real world counterpart (real world “Things”, e.g. devices like sensors, smart heating, connected cars, smart grids, EV charging stations, …).
An ever growing list of [adopters](https://iot.eclipse.org/adopters/?#iot.ditto) makes use of Ditto as part of their IoT platforms - if you're as well using it, it would be super nice to show your [adoption here](https://iot.eclipse.org/adopters/how-to-be-listed-as-an-adopter/).
## Documentation
Find the documentation on the project site: [https://www.eclipse.dev/ditto/](https://www.eclipse.dev/ditto/)
## Eclipse Ditto™ explorer UI
Find a live version of the latest explorer UI: [https://eclipse-ditto.github.io/ditto/](https://eclipse-ditto.github.io/ditto/?primaryEnvironmentName=ditto_sandbox)
You should be able to work with your locally running default using the `local_ditto` environment - and you can add additional environments to also work with e.g. with a deployed installation of Ditto.
## Star History
## Getting started
In order to start up Ditto via *Docker Compose*, you'll need:
* a running Docker daemon
* Docker Compose installed
* for a "single instance" setup on a local machine:
* at least 2 CPU cores which can be used by Docker
* at least 4 GB of RAM which can be used by Docker
You also have other possibilities to run Ditto, please have a look [here](https://github.com/eclipse-ditto/ditto/tree/master/deployment) to explore them.
### Start Ditto
In order to start the latest built Docker images from Docker Hub, simply execute:
```bash
cd deployment/docker/
docker-compose up -d
```
Check the logs after starting up:
```bash
docker-compose logs -f
```
Open following URL to get started: [http://localhost:8080](http://localhost:8080)
Or have a look at the ["Hello World"](https://www.eclipse.dev/ditto/intro-hello-world.html)
Additional [deployment options](deployment/) are also available, if Docker Compose is not what you want to use.
## Development Guide
If you plan to develop extensions in Ditto or to contribute some code, the following steps are of interest for you.
> :warning: **If you just want to start/use Ditto**, please ingore the following sections!
### Build and start Ditto locally
In order to build Ditto, you'll need:
* JDK >= 21
* Apache Maven >= 3.9.x installed.
* a running Docker daemon
In order to first build Ditto and then start the built Docker images.
#### 1. Build Ditto with Maven
```bash
mvn clean install
```
Skip tests:
```bash
mvn clean install -DskipTests
```
#### 2. Build local Ditto Docker snapshot images
```bash
./build-images.sh
```
If your infrastructure requires a proxy, its host and port can be set using the `-p` option like for example:
```bash
./build-images.sh -p 172.17.0.1:3128
```
Please note that the given host and port automatically applies for HTTP and HTTPS.
#### 3. Start Ditto with local snapshot images
```bash
cd ../deployment/docker/
# the "dev.env" file contains the SNAPSHOT number of Ditto, copy it to ".env" so that docker compose uses it:
cp dev.env .env
docker-compose up -d
```
Check the logs after starting up:
```bash
docker-compose logs -f
```
You have now running:
* a MongoDB as backing datastore of Ditto (not part of Ditto but started via Docker)
* Ditto microservices:
* Policies
* Things
* Things-Search
* Gateway
* Connectivity
* an nginx acting as a reverse proxy performing a simple "basic authentication" listening on port `8080`
* including some static HTTP + API documentation on [http://localhost:8080](http://localhost:8080)