100% open-source IoT Platform - Integrate your devices, create rules, and analyse and visualise your data
Welcome to the OpenRemote 3.0 platform; an intuitive user-friendly 100% open source IoT platform. We have our origins in Home Automation but our 3.0 platform is focused on generic IoT applications and is a completely different stack to any of our 2.x services. As the code base is 100% open source then the applications are limitless. Here's an architecture overview:
You can quickly try the online demo with restricted access, login credentials are
The quickest way to get your own environment with full access is to make use of our docker images (both
arm64are supported). 1. Make sure you have Docker Desktop installed (v18+). 2. Download the docker compose file: OpenRemote Stack (Right click 'Save link as...') 3. In a terminal
cdto where you just saved the compose file and then run:
docker-compose pull docker-compose -p openremote upIf all goes well then you should now be able to access the OpenRemote Manager UI at https://localhost. You will need to accept the self-signed certificate, see here for details how to do this in Chrome (similar for other browsers).
The URL you use to access the system is important, the default is configured as
https://localhostif you are using a VM or want to run on a different port then you will need to set the
EXTERNAL_URLenvironment variable and if changing ports you'll need to update your docker compose profile, so if for example you will be accessing using
https://192.168.1.1:8443then update your
proxy: ... ports: - "8000:80" - "8443:443" - "8883:8883"
Then use the following startup command:
EXTERNAL_URL=https://192.168.1.1:8443 docker-compose -p openremote up -dor
cmd /C "set EXTERNAL_URL=https://192.168.1.1:8443 && docker-compose -p openremote up -d"
Try creating assets, agents, rules, users, realms, etc. using the Manager UI, please refer to the wiki for more information, some things to try:
Persistent data is stored in a PostgreSQL DB which is stored in the
openremote_postgresql-datadocker volume which is durably stored independently of the running containers (see all with
docker volume ls). If you want to create a backup of your installation, just make a copy of this volume.
We work with Java, Groovy, TypeScript, Gradle, Docker, and a wide range of APIs and protocol implementations. Clone or checkout this project and send us pull requests, ensure that code is covered by tests and that the full test suite passes.
For more information and how to set up a development environment, see the Developer Guide.
Join us on the community forum.