Plan what you eat, not just log it. Nutria is a self-hosted macro tracker and
meal planner, free and open source.
- Set your budget: daily calories and a protein/carbs/fat split, divided
across your meals.
- Build your library: ingredients, by hand or imported from Open Food
Facts, combined into reusable meals.
- Plan your week: put meals on a calendar and see each slot's budget
before you eat.
- Tick off today: mark what you ate, swap what changed, see what's left.
[!IMPORTANT]
Nutria is a planning tool, not medical advice. If you manage your diet for a
health condition, follow your doctor or dietitian.
Documentation:
deploy it ·
user guide
Quick start
With Docker and Docker Compose:
git clone https://github.com/alvfdz/nutria.git
cd nutria
git checkout vX.Y.Z # the latest release: github.com/alvfdz/nutria/releases
cp .env.example .env # set POSTGRES_PASSWORD, BETTER_AUTH_SECRET and BETTER_AUTH_URL
docker compose up -d --build --wait
Then open http://localhost:3000. The
self-hosting guide
explains each setting, reverse proxies and updates.
Contributing
Built with Next.js, TypeScript, Tailwind CSS, shadcn/ui and PostgreSQL via
Prisma. CONTRIBUTING.md covers the development setup and
workflow, and CODE_OF_CONDUCT.md what to expect from
a hobby project. docs/vision.md sets the product direction, and
docs/design-system.md sets the look of every screen.
License
Nutria's code is released under the MIT License. It is provided "as
is", with no warranty and no support of any kind.
Third-party code copied into this repository, and the fonts bundled at build
time, keep their own licenses: see
THIRD_PARTY_NOTICES.md.
Food data
The MIT License does not cover food data. Food search results come from
Open Food Facts contributors. The database is
available under the Open Database License, its individual contents under the
Database Contents License, and product images under Creative Commons
Attribution-ShareAlike. See their
terms of use.
This data may contain errors and must not be used for medical purposes. Nutria
is not medical advice.
