Skip to main content

These are the docs for 0.26.0-beta, an older release.

See the current docs (0.26.1-beta) for what Norish does today.
  1. Configuration
  2. Admin settings

Admin settings

Manage server settings under Settings => Admin. Most changes apply right away; a badge marks those that need a restart.

  • Users
  • Registration, whether new accounts are allowed
  • Permissions for recipes and ingredients
  • Sign-in providers
  • OIDC claim mapping for admin roles and household auto-join
  • Content detection: units, ingredient words, content indicators and recurrence
  • Page renderers for imports
  • AI and video processing, see AI provider
  • The job queues
  • The scheduler and a server restart

Permissions

Recipes sets who may view, edit and delete a recipe someone else added: everyone, the household, or only the owner.

Ingredients sets who may edit an ingredient someone else added. The whole server shares one ingredient catalogue.

  • Everyone: any signed-in user.
  • Household: the person who added it and their household. This is the default.
  • Owner only: only the person who added it.

Merging ingredients requires permission on both. Anyone can add a translation.

Ingredient words

Content detection => Ingredient words holds the words used to identify foods in ingredient lines. Each locale has its own lists. All lists apply to every recipe because its language is unknown.

These words are taken off the name:

  • preparation: what was done to the food. "Finely chopped onion" is onion.
  • sizes: "2 large onions" is onions. A size used as the unit, as in "2 large", counts pieces.
  • approximately: words that make an amount a guess, like "about" in "about 200 g flour".
  • connectors: the word between an amount and the food, like "of" in "a pinch of nutmeg".
  • joiners: the word between two preparations, like "and" in "peeled and chopped ginger". It is only removed between preparations.

These words split a line into separate foods:

  • together: foods you need all of, like "and" in "salt and pepper". The grocery list gets salt and pepper.
  • alternatives: foods where any one will do, like "or" in "butter or oil". The grocery list gets only the first, butter. A shorter part borrows the other part's words, so "cherry or grape tomatoes" is cherry tomatoes or grape tomatoes.

Both lists also accept symbols: "&" and "+" in together, "/" in alternatives, with or without spaces ("salt/pepper"). A line is split only when each part is a known food, and never when the whole name is known ("mac and cheese").

These words help identify the food name:

  • endsBefore: words that start a note after the name. "Tuna in olive oil" is tuna, and "greek yogurt for topping" is greek yogurt.
  • forms: cuts and forms that follow a food's name. "Chicken strips" goes under chicken. A cut on its own is never a food, so "carrot julienne" also goes under carrot.
  • notFoods: words that never name a food on their own, like "the" or "some".
  • inflections: plural endings and the singular ending each stands for, so "onions" is onion and "cherries" is cherry.

Job queues

Imports, enrichment and other long tasks run as background jobs. Settings => Admin => Job queues lists them as waiting, running, finished, failed or cancelled. Open a job for details.

Cancelling a job

Open a running job and press Stop. AI requests stop at once; other work finishes its current step while the button reads Stopping…. The job then shows as Cancelled. It is not retried automatically; press Retry to run it again.