Back to all templates
Grocy logo

Grocy

Application128MB+ RAM

ERP-style household management: groceries, chores, meal planning, and recipes

applicationautomationgrocyopen-sourceself-hosteddocker

Deploy Grocy in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Grocy

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Grocy on a VPS with Server Compass

Use the Grocy template in Server Compass to deploy a self-hosted household management app on your VPS, then verify the login page.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Grocy app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Grocy

Use the template picker search to find Grocy in the Server Compass template catalog.

Searching for Grocy in the Server Compass template picker
4
Step 4

Select the Grocy template

Choose the Grocy template. Server Compass fills the LinuxServer Grocy service, persistent config volume, timezone, user IDs, and public web port.

Grocy template selected in Server Compass
5
Step 5

Review the Grocy settings

Confirm the app name and compose service. In this run, the app was named grocy-demo and used host port 4031.

Reviewing Grocy project settings and compose service
6
Step 6

Deploy Grocy

Review the generated compose settings, confirm the Grocy web port is available, and click Deploy.

Reviewing Grocy web port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Grocy image, starts the container, and verifies the stack.

Server Compass deploying the Grocy template on the VPS
8
Step 8

Confirm Grocy is running

After deployment finishes, return to the Apps tab and confirm the Grocy app is marked Running with its application URL available.

Grocy template running in the Server Compass Apps tab
9
Step 9

Open Grocy in the browser

Open the application URL in a browser. The Grocy login page confirms the household management app is reachable and ready for first-run setup.

The deployed Grocy web UI loaded in a browser

After Grocy Opens

  • Sign in with admin/admin, then immediately change the default password.
  • Put Grocy behind HTTPS before adding private household data.
  • Back up the Grocy config volume because it stores application data and configuration.
  • Configure products, locations, recipes, and chores before inviting other household users.
  • Keep the Grocy image updated for PHP and application security fixes.

Verified Result

The Grocy login page loaded successfully from the deployed container.

Grocy deployment questions

What does the Grocy template deploy?

It deploys the LinuxServer Grocy image with a persistent config volume and no external database.

Which port did the tutorial use?

The tutorial used host port 4031, which maps to the Grocy web UI on container port 80.

Does Grocy need setup after deployment?

Yes. Sign in with the default admin/admin credentials, then change the password and configure your household, products, recipes, locations, and chores.

Should this become a blog post?

No. The deployment guide should live on the Grocy template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying Grocy with Server Compass, complete these steps to finish setup

1

Visit the application URL

2

Log in with admin / admin

3

Change the admin password in user settings

4

Configure your household, products, and locations

Need help? Check out our documentation for detailed guides.

Grocy FAQ

Common questions about self-hosting Grocy

How do I deploy Grocy with Server Compass?

Simply download Server Compass, connect to your VPS, and select Grocy from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Grocy?

Grocy requires a minimum of 128MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Grocy data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Grocy backup and restore procedures.

How do I update Grocy to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Grocy image will be pulled and deployed with zero downtime.

Is Grocy free to self-host?

Grocy is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Grocy?

Download Server Compass and deploy Grocy to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass