Home Assistant Companion vs Mushroom

A side-by-side comparison of two self-hosted home automation options — licensing, setup difficulty, resource needs, and what each one replaces.

Not the right match-up?
FeatureHome Assistant CompanionMushroom
CategoryHome AutomationHome Automation
LicenseApache-2.0Apache-2.0
LanguageKotlinTypeScript
Setup difficultyEasyEasy
Min. RAM64 MB32 MB
Deploymentsourcesource
GitHub stars★ 3,788★ 5,098
First released20202022
ReplacesGoogle Home appproprietary smart home apps

Why pick each one

Choose Home Assistant Companion if…

  • Turns phones into sensors
  • Tight HA integration
Home Assistant Companion details

Choose Mushroom if…

  • Released under the Apache-2.0 license
  • Easy to set up — beginner-friendly
  • Mature project with 5.1k GitHub stars
  • Written in TypeScript
Mushroom details

Frequently asked questions

Is Home Assistant Companion or Mushroom better?

Neither is universally better. Mushroom has the larger community; both share a easy setup difficulty, so the decision comes down to features and licensing.

Are Home Assistant Companion and Mushroom free and open-source?

Yes. Home Assistant Companion is licensed under Apache-2.0 and Mushroom under Apache-2.0. Both can be self-hosted at no software cost.

Can I run Home Assistant Companion and Mushroom with Docker?

Home Assistant Companion: check the project docs for container support. Mushroom: check the project docs for container support.

Related comparisons