selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Open Home Foundation Matter Server logo

Self-host Open Home Foundation Matter Server

v1.5.5

Matter controller server with WebSocket API and dashboard

ReleaseOpen SourceApache-2.0
Updated4 days ago
LanguageTypescript
Setup difficultyAdvanced
ThemeDark mode
Stars
401
Port
5580 (WebSocket API and HTTP dashboard)
Requires
Node.js
Docker
ghcr.io/matter-js/matterjs-server
Install with Docker

What is Open Home Foundation Matter Server?

A JavaScript implementation of a Matter controller that communicates over WebSockets. Built on the matter.js SDK, it provides a WebSocket API compatible with the Python Matter Server and includes a web dashboard for managing commissioned devices, viewing Thread and WiFi network topology, and adjusting log levels. It supports Matter 1.6, BLE commissioning, OTA firmware updates, custom PAA certificates, and device attestation revocation sets. The server can run standalone via Docker, npm, or from source, and is designed primarily as the backend for Home Assistant's Matter integration but works with other projects too. It requires Node.js 22.13+ and uses the CSA Distributed Compliance Ledger for device certification verification.

Should you self-host Open Home Foundation Matter Server?

Open Home Foundation Matter Server scores 56/100 on selfhost.directory (how scoring works) and ranks #42 of 104 in Home Automation. It has 401 GitHub stars.

It shipped 6 stable releases in the past year. The latest, v1.5.5, came out on 24 October 2026. New versions land roughly every 1 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Home Assistant (91/100, 91 796 stars). It scores higher overall, so compare the two before you pick. See Open Home Foundation Matter Server vs Home Assistant side by side.

Features

  • BLE Commissioning
  • BLE Proxy Mode
  • Custom OTA Firmware Import
  • Custom PAA Certificates
  • Device Attestation Revocation Sets
  • Matter 1.6 Support
  • mDNS Border Router Discovery
  • OTA firmware updates
  • Python Matter Server Migration
  • Reverse Proxy Support
  • Runtime log level control
  • Thread Network Visualization
  • Web Dashboard
  • WebSocket API
  • WiFi Network Visualization

Open Home Foundation Matter Server README

How to install Open Home Foundation Matter Server

Install Open Home Foundation Matter Server with Docker

Docker with host networking support
Environment variables
STORAGE_PATH, PORT, LISTEN_ADDRESS, LOG_LEVEL, PRIMARY_INTERFACE, ENABLE_TEST_NET_DCL, BLE_PROXY, etc.

mkdir data docker run -d
--name matterjs-server
--restart=unless-stopped
-v $(pwd)/data:/data
--network=host
ghcr.io/matter-js/matterjs-server:stable

Requires host networking for mDNS/Thread discovery

How to configure Open Home Foundation Matter Server

  • BLE_PROXYfalseExpose /ble WebSocket endpoint for remote BLE proxy

    Expose /ble WebSocket endpoint for remote BLE proxy

    values: true/false

  • BLUETOOTH_ADAPTERnoneBluetooth adapter HCI ID

    Bluetooth adapter HCI ID

    values: e.g., 0 for hci0

  • DCL_OFFLINEfalseCheck attestation against DCL seed only

    Check attestation against DCL seed only

    values: true/false, 1/0, yes/no, on/off

  • DISABLE_DASHBOARDfalseDisable the web dashboard

    Disable the web dashboard

    values: true/false, 1/0, yes/no, on/off

  • DISABLE_DCL_SEEDfalseDisable bundled offline DCL seed

    Disable bundled offline DCL seed

    values: true/false, 1/0, yes/no, on/off

  • DISABLE_OTAfalseDisable OTA update functionality

    Disable OTA update functionality

    values: true/false, 1/0, yes/no, on/off

  • ENABLE_TEST_NET_DCLfalseEnable test-net DCL certificates/OTA updates

    Enable test-net DCL certificates/OTA updates

    values: true/false, 1/0, yes/no, on/off

  • ENABLE_TIME_SYNCfalseAutomatic time sync for supported devices

    Automatic time sync for supported devices

    values: true/false, 1/0, yes/no, on/off

  • FABRIC_ID1Fabric ID for the Fabric

    Fabric ID for the Fabric

    values: Any valid fabric ID

  • LISTEN_ADDRESSall interfacesIP address(es) to bind WebSocket server

    IP address(es) to bind WebSocket server

    values: Comma-separated IP addresses, interface names or unix socket paths

  • LOG_FILEnoneLog file path

    Log file path

    values: e.g. /data/logs/matter-server.log

  • LOG_LEVELinfoServer logging verbosity

    Server logging verbosity

    values: critical, error, warning, info, debug, verbose

  • OTA_PROVIDER_DIRnoneDirectory for OTA Provider files

    Directory for OTA Provider files

    values: Any valid directory path

  • PORT5580WebSocket server port

    WebSocket server port

    values: Any valid port number

  • PRIMARY_INTERFACEauto-detectPrimary network interface for mDNS

    Primary network interface for mDNS

    values: e.g., eth0, en0

  • PRODUCTION_MODEfalseForce dashboard production mode (reverse proxy)

    Force dashboard production mode (reverse proxy)

    values: true/false, 1/0, yes/no, on/off

  • REVOCATION_SETS_DIRnoneDirectory with device attestation revocation sets

    Directory with device attestation revocation sets

    values: Any valid directory path

  • STORAGE_PATH/dataPath to store Matter fabric data

    Path to store Matter fabric data

    values: Any valid path

  • VENDOR_ID0xfff1Vendor ID for the Fabric

    Vendor ID for the Fabric

    values: Any valid vendor ID

Open Home Foundation Matter Server releases & version history

More in Smart Home

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…