Home Assistant Community Add-on: Grocy

Tags: #<Tag:0x00007fc4172f8428> #<Tag:0x00007fc4172f8360>

This add-on is provided by the Home Assistant Community Add-ons project.

GitHub Release GitLab CI Project Stage Project Maintenance

Supports armhf Architecture Supports armv7 Architecture Supports aarch64 Architecture Supports amd64 Architecture Supports i386 Architecture

ERP beyond your fridge! A groceries & household management solution for your home.


Grocy - ERP beyond your fridge is a powerful groceries & household management solution for your home, delivering features like:

  • Stock management
  • Shopping list
  • Recipes
  • Chores & tasks
  • Inventory
  • and many more.

Try out the online demo of Grocy.


The installation of this add-on is pretty straightforward and not different in comparison to installing any other add-on.

  1. Search for the “Grocy” add-on in the add-on store.
  2. Install the “Grocy” add-on.
  3. Start the “Grocy” add-on.
  4. Check the logs of the “Grocy” add-on to see if everything went well.
  5. Click on the “OPEN WEB UI” button to get into the interface of Grocy.
  6. The default login is user: admin password: admin.
  7. Enjoy the add-on!

:books: Please read the documentation for more information about the use and configuration of this add-on.


You can always try to get support from the community here at the Home Assistant community forums, join the conversation!

Questions? You have several options to get them answered:

You could also open an issue on GitHub, in case you ran into a bug, or maybe you have an idea on improving the addon:

:information_source: At this moment our Home Assistant Community Add-ons Discord chat server and GitHub are our only official support channels. All others rely on community effort.

Repository on GitHub

Looking for more add-ons?

The primary goal of our add-ons project is to provide you (as a Home Assistant user) with additional, high quality, add-ons that allow you to take your automated home to the next level.

Check out some of our other add-ons in our Home Assistant Community Add-ons project.


About the author of this add-on

Hi there!

I am Franck Nijhof, and I have 30 years of programming experience, in many languages. I am using this experience to work on the Home Assistant project by giving back my knowledge and time to the open source community.

The add-on you are currently looking at right now was developed/packaged by me. It is not the only add-on I have created; there are many many more :wink:

However, I have a problem… I am an addict. A :coffee: addict that is. Lucky for you, I turn that C8H10N4O2 (caffeine molecule) into code (and add-ons)!

If you want to show your appreciation, consider supporting me for buying a cup of high octane wakey juice via one of the platforms below! :heart:

Sponsor Frenck via GitHub Sponsors

Support Frenck on Patreon

Enjoy your add-on, while I enjoy the brain juice. :coffee:

Thanks for all the :two_hearts:


Join our Discord server Follow me on Twitter Flollow me on Instragram Follow me on GitHub Follow me on YouTube Follow me on Twitch patreon-icon

P.S.: In case you want to ask me a question: AMA (Ask Me Anything). Most of the time I am online at the Discord chat. (I go by @Frenck in there as well).

Awesome work mate!

Thank you!

Whats stopping the external lookup via barcode from working via the addon? Would make the initial infill of stock much easier!

1 Like

@CountParadox Simply the lack of providers and plugins for Grocy at this point.
Definitely something to add/create in a future release.


Thanks again @frenck will have to check this out.

1 Like

I can’t wait to try this out, it looks pretty cool. Any chance it will gain Ingress functionality?

1 Like

@frenck really nice addon!! the chores part is something i have been looking for! a question thou. In the documentation there is a language spec, but in the demo there are more to choose from. In the Demo i can choose swedish but not in the plugin configuration. Why is that?

Is this got an add in to be able to alert when say milk is low to say home assistant ios app?

This language was added recently, you can expect this to be available in the next add-on release.

1 Like

Very nice addon and it’s really tikes the WAF. As in, she is more exited for this, than me.

I see in the github that the latest version of grocy (2.4.1) is added to the master. How can I get this version in my Hassio?

:tada: Release v0.2.0

Full Changelog

This release updates Grocy to v2.4.1!
Adds some neat new features: Meal planning, custom user fields, new languages & tons of improvements!

:hammer: Changes

  • :arrow_up: Upgrades nginx to 1.14.2-r1
  • :arrow_up: Upgrades PHP to 7.2.18-r0
  • :arrow_up: Upgrades add-on base image to 3.1.1
  • :arrow_up: Upgrades Grocy to v2.4.1 (#20) (@tjorim)
  • :ambulance: Ensures viewcache folder exists

Questions? Join our Discord server! https://discord.me/hassioaddons
Enjoying my add-ons? Consider supporting my work: https://patreon.com/frenck

Just updated, can’t get Swedish configured. What country code should it be?

sv_SE, I should have updated the readme but don’t have time now.

1 Like

Swedish currency also? Skr or kr?
Edit: never mind kr worked.

I am having trouble using the meal planning. I click the ‘+’ sign, and nothing happens. No error message, no widow to add a recipe, nothing. I try to change the week, and the dates in the upper left changes, but the actual week doesn’t change. Basically the meal planning doesn’t work at all. Anyone else having any issues with it? Running the latest version of Hassio and the latest version of the addon.

Thanks in advance.

I’m having the same issues. Version 0.2.0 doesn’t really work. I don’t see my date in the normal overviews, but they are there deeper down.
I’ve created some issues, but have reverted back to version 0.1.0 for now.

Hi, I wanted to play around with the grocy api in javascript but I get an CORS error. Response to preflight request doesn’t pass access control check: No ‘Access-Control-Allow-Origin’ header is present on the requested resource. How can I edit the ngix header stuff in hassio/grocy?

:tada: Release v0.3.0

Full Changelog

:sparkles: This release adds support for Hass.io Ingress :tada:

Besides Ingress, this release adds major upgrades about every single thing inside this add-on :arrow_up:

:rotating_light:Breaking change

The addition of Ingress makes this add-on not accessible directly. If you have added Grocy via an iframe panel, this release will break that. However, you can simply toggle the “Show in sidebar” switch now :tada:

You can enable direct access again by going into the add-on configuration. A section is visible: “Network”. Enter port 9192 (or anything else if you want) in the disabled field. Hit the “SAVE” followed by the “RESTART” button to make your iframe and others work as before.

:hammer: Changes

  • :arrow_up: Upgrades Grocy to v2.4.2
  • :sparkles: Adds en_GB as selectable language
  • :pencil2: Maintaince -> Maintenance
  • :arrow_up: Upgrades add-on base image to v4.0.1
  • :arrow_up: Upgrades nginx to 1.16.0-r2
  • :arrow_up: Upgrades php to 7.3.6-r0
  • :arrow_up: Upgrades git to 2.22.0-r0
  • :arrow_up: Upgrades yarn to 1.16.0-r0
  • :arrow_up: Upgrades composer to 1.8.6-r0
  • :sparkles: Adds FUNDING.yml
  • :sparkles: Adds Ingress support
  • :fire: Removes now deprecated ssl directive
  • :books: Adds extra language option to docs (#26) (@tjorim)
  • :hammer: Disable direct access by default
  • :ambulance: Adds missing port declaration

Questions? Join our Discord server! https://discord.me/hassioaddons
Enjoying my add-ons? Consider supporting my work: https://patreon.com/frenck

Having exactly the same issues as with version 0.2.0. I’ll give some addidtion to the issues.

Maybe it’s something with the settings in hassio or Grocy itself on version 0.1.0 that’s not compatible with version 0.2.0 and higher. So restarting might solve the issue. But it would mean I’m losing the products, stock and recipes. How can I restart while keeping that data? Als asking it here: https://github.com/hassio-addons/addon-grocy/issues/29

For those who use the custom component for hass (found in HACS) I’m sharing the beta version of my card for displaying and tracking chores in Lovelace. This is beta and it might have lots of bugs.
GitHub repo
I have added this as a default repo in HACS.