Project Atlas AetherDev project hub
Atlas project production

openhab-config

Production config-as-code repository for openHAB, including items, things, rules, services, transforms, and runtime state artifacts.

Internal-only entry. Do not publish externally without review.
Type
System
Lifecycle
Active
Last touched
2026-03-25
Visibility
Internal

Purpose

Version and operate openHAB automation behavior safely through Git-managed configuration.

Current state

Production-backed repository with clear structure and supporting docs (`etc/README.md`, development guide, AGENTS notes).

Next step

Expand validation coverage and document backup/recovery procedures for high-impact config/state changes.

Interfaces

Inputs
  • openHAB config files under etc/
  • Runtime state under userdata/
Outputs
  • openHAB runtime behavior
  • Automation rule execution
  • Monitoring and control surfaces

Reality to Action trace

Reality Ingestion

Not in scope.

Canonical Storage

Not in scope.

Automation Engines

Contributes in this stage.

Human Interfaces

Not in scope.

Operational Adoption

Contributes in this stage.

Core workflow

TBD. Document the 5-10 steps that define the core workflow.

Artifacts

  • etc/items
  • etc/things
  • etc/rules
  • etc/transform
  • userdata/jsondb

Operational notes

Constraints and scars

  • JSONDB state artifacts can drift from desired text-config intent.
  • Pushing config can act as production deploy.

Reliability posture

Strong operational value with clear config-as-code pattern; malformed configs can break runtime and must be validated before deploy.

Observability

  • openHAB logs
  • Rule execution behavior
  • Validation helper script in scripts/tests

Security and privacy

Treat this as production runtime config. Avoid committing credentials/tokens and review userdata changes for sensitive material.

Dependencies

Upstream
  • openHAB runtime
  • Configured bindings/devices
  • Deployment sync workflow
Downstream
  • Home automation operations
  • Related telemetry/streaming workflows

Ownership

Owners

Josh Barton

Users

Home/infra operators, Maintainers

openhab-config

Practical Scope

This repo is a live configuration surface, not a static reference archive. Changes here can immediately affect production automation behavior.