# Grocy

> Groceries, pantry stock, shopping lists and chores.

- Page: https://cgt.octabyte.io/templates/grocy/
- Category: Home & family
- Replaces: OurGroceries and Sortly
- Ease of use: Some setup. Sign in as admin with the password Cloudgate created, then add your storage places and the products you buy before Grocy starts to pay off.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: Households who want to track food at home, waste less and share shopping lists and chores
- Official website: https://grocy.info
- Documentation: https://github.com/grocy/grocy#readme
- Source code: https://github.com/grocy/grocy
- Last updated: 2026-11-20

## What is Grocy?

Grocy is a self-hosted household app that tracks the food you have at home, warns before it expires, fills your shopping list and shares chores.

Grocy is a free, open-source, self-hosted groceries and household management app that tracks the food you have at home, what's due soon and what to buy, in place of shopping-list and inventory apps such as OurGroceries or Sortly. It also keeps recipes, a meal plan and the household's chores in the same place.

You book what you buy and what you use, by hand or with a barcode scanner, and Grocy keeps count. It warns you before food expires, adds staples to the shopping list when they run low, and shows which recipes you can cook with what's in stock. A family of four, for example, could scan the weekly shop as they unpack it, see on Thursday that the yogurt is due tomorrow, and find milk already on the list when it runs out.

Grocy runs in any browser and can be added to a phone's home screen. Community apps for Android and iPhone add faster barcode scanning, and it looks up new products in Open Food Facts. Setting it up takes some time, since you first add your storage places and the products you buy.

Cloudgate installs Grocy on a server Cloudgate provides or one you connect, and gives it a secure web address. Sign in as admin with the password Cloudgate created.

## What you can do with Grocy

- **Know what you have at home**: See every product, how much is left, where it is kept and when it is due, with expired and soon-due items highlighted.
- **Scan barcodes as you shop or unpack**: Book purchases and use-ups with a barcode scanner or your phone's camera, and look up new products in the free Open Food Facts database.
- **Let the shopping list fill itself**: Set a minimum amount for the things you always need, and Grocy adds them to the list, grouped to follow your route through the supermarket.
- **Cook from what's in stock**: Keep recipes that show whether you have every ingredient, add what's missing to the list, and see which recipes use up food that's due soon.
- **Plan the week's meals**: Fill breakfast, lunch and dinner for each day, with the cost of each meal, and send the missing ingredients to the shopping list in one click.
- **Share chores and tasks**: Schedule chores like taking out the trash, assign them to household members, and see what's overdue at a glance.
- **Keep track of the rest of the house**: Note when batteries were last charged, keep manuals for your appliances in one place, and add your own lists and fields.

## Replaces OurGroceries and Sortly

Grocy does the same job as OurGroceries and Sortly. Here is what changes when you switch.

### What you gain

- Free and open source, with no paid tier
- Tracks what's already at home and when it is due, not only what to buy
- Stock, recipes, meal plan and chores in one app the household shares
- Your household's data stays on your own server

### What is different

- It takes some setup first, adding your products, storage places and minimum amounts
- The phone apps are made by the community, not by the Grocy project
- The web app has no offline mode
- There is no importer from other grocery or inventory apps

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=grocy

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Grocy itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up Grocy.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is Grocy free?

Yes, Grocy is free and open source under the MIT licence, with no paid edition or locked features. You pay only for your server.

### Is Grocy a good alternative to OurGroceries?

Yes, if you want more than a shared list. Grocy also tracks what is already in your cupboards, when food is due, recipes, a meal plan and chores. OurGroceries is simpler to start with and has its own phone apps; Grocy needs you to set up your products first.

### Can Grocy scan barcodes?

Yes. Grocy works with a USB barcode scanner or your phone's camera in the browser, and it can look up an unknown barcode in Open Food Facts to add the product for you.

### Is there a Grocy app for iPhone or Android?

Yes, community-made ones. Grocy Android is free on Google Play and F-Droid, and Grocy Mobile is an app for iPhone and Mac; both connect to your own Grocy. You can also add Grocy's website to a phone's home screen.

### How do I sign in to Grocy the first time?

Sign in with the user name admin and the password Cloudgate created, shown in your app's settings in Cloudgate. Grocy's well-known default password is replaced at first start, and you can change the password later from the user menu.

### Can the whole household use one Grocy?

Yes. Add each person as a user in Grocy; everyone shares the same stock, shopping lists and recipes, and chores can be assigned to a person.

### Does Grocy work offline?

No, the Grocy website needs a connection to your server. The community Grocy Android app can keep shopping lists available offline while you shop.

### Do I need technical skills to run Grocy?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Grocy and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for Grocy?

No. When you deploy Grocy, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.

### Can I move my data from OurGroceries to Grocy?

Most people export from OurGroceries and import into Grocy. The official guides at github.com walk through it.
