Part of SUPLA — an open smart home platform that brings together hardware manufacturers, the community, and users.
Learn more at https://www.supla.org
supla-cloud is the Cloud web application and REST API of the SUPLA platform.
It provides user-facing services such as configuration, automations, and integrations,
and is used by official SUPLA services as well as self-hosted deployments.
This repository contains:
- the Cloud backend application,
- the REST API used by mobile apps, integrations, and partners,
- the web-based user interface (frontend).
It is a core backend component of the SUPLA ecosystem, but not a complete SUPLA server stack on its own.
A full, production-ready SUPLA installation also requires server components responsible for device communication.
SUPLA consists of multiple components that together form a complete smart home platform, including device firmware, server-side services, cloud applications, and deployment tooling.
For a high-level overview of the SUPLA architecture and how individual repositories fit together, see the SUPLA organization repository:
For running your own SUPLA instance (recommended way for self-hosting and production), use SUPLA Docker:
👉 github.com/SUPLA/supla-docker
supla-docker provides:
- a complete set of SUPLA services,
- Docker-based deployment,
- upgrade paths and operational configuration.
This repository is not intended to be used directly for production deployments.
This repository is intended for:
- SUPLA core contributors,
- backend and frontend developers,
- contributors working on the REST API or Cloud behavior.
For local development setup, see:
SUPLA Cloud exposes a public REST API used by:
- mobile applications,
- third-party integrations,
- partner solutions.
API documentation is available via Swagger:
Changes to public API endpoints must remain backward compatible whenever possible.
- Backend: Symfony, Doctrine
- Frontend: Vue.js
- Deployment (production): Docker (via
supla-docker)
Contributions are welcome.
Please read:
CONTRIBUTING.md– contribution rules and workflowSECURITY.md– how to report security issues
SUPLA Cloud releases are tagged using CalVer versioning variant: 0Y.0M[.MICRO] (see calver.org).
Versioned releases and release notes are available on GitHub:
For an overview of the SUPLA platform and ecosystem, see:
This project is licensed under the GPL-2.0 license.