← All support

Forked — Support

Getting Started

Forked connects to your self-hosted Mealie server and helps you discover meals, plan your week, and build shopping lists. Currently, Forked supports Mealie with more servers planned.

To get started, you need:

  1. A running Mealie instance (self-hosted or cloud)
  2. A Mealie API token (generated from your Mealie user profile)

Open Forked, enter your server's root hostname or IP address and API token, and your recipes will sync automatically. Forked tries HTTPS first. Plain HTTP is only supported for private IPs, localhost, or .local names. If your private-network server uses mkcert or another self-signed HTTPS certificate, enable "Trust local self-signed HTTPS." Common homelab DNS suffixes such as .lab, .lan, and home.arpa should stay on HTTPS.

Common Questions

How do I get a Mealie API token?

Log in to your Mealie server, go to your user profile, navigate to API Tokens, and create a new token. Copy it into Forked's setup screen.

My recipes aren't syncing

Check that your server address is correct and your device can reach it. If your Mealie server is on your local network, make sure your iPhone is on the same Wi-Fi network. Allow Forked to access your local network when prompted. If you are connecting remotely, use HTTPS. If your local HTTPS proxy uses mkcert or another self-signed certificate, enable the "Trust local self-signed HTTPS" option. Plain HTTP fallback is only for private IPs, localhost, or .local names, so a custom LAN hostname such as mealie.lab still needs HTTPS. Forked does not support public plain HTTP or Mealie hosted under a path like /mealie.

Which connection setups are supported?

Forked supports Mealie on a root hostname or IP address. Known-good paths today are direct LAN access, local plain HTTP on private addresses, public HTTPS, Tailscale with HTTPS enabled, Caddy/Traefik reverse proxies at a dedicated host, Cloudflare Tunnel for review/demo access, and local/private HTTPS with a self-signed or mkcert certificate when you enable the Trust local self-signed HTTPS toggle. Interactive auth walls such as Authentik or Cloudflare Access must not sit in front of the Mealie API routes Forked uses.

I use Caddy, Traefik, Authentik, or Cloudflare Access. What matters?

Your proxy must preserve the Authorization header and expose Mealie at the host root. If you use an auth gateway, bypass the Mealie API and media routes or give Forked a separate hostname that reaches Mealie directly. Forked cannot complete browser-based login flows during API sync.

Why do recipes sync but images are missing?

Forked expects recipe data and images to come from the same server address. If your Mealie server serves images from a different hostname, images may not load. Using the same hostname for both the API and images usually fixes the problem.

Which recipe servers does Forked support?

Forked currently supports Mealie. Support for additional recipe servers is planned for future updates.

How do I set up dietary filters?

Go to your Chef Profile in the app. You can set allergies, dietary preferences (vegan, halal, gluten-free, etc.), and liked/disliked ingredients. Forked will automatically filter recipes based on your profile.

Does Forked change my Mealie favorites or ratings?

No. Forked can read synced Mealie favorites and ratings so your Chef Profile can prefer favorites or ignore low-rated recipes. Forked does not write favorite or rating changes back to Mealie.

How do I share a shopping list?

Open the Shopping tab, build your list from a meal plan, selected My Picks, or the bottom-right add button, then tap the share button. You can paste several manual items on separate lines, search by item name, and clear checked/all items from list cleanup before sharing. The iOS share sheet lets you send or save the list using apps available on your device.

How do I restore my tip?

Tips are optional consumable purchases and do not unlock features, so there is nothing to restore. If you have trouble with a purchase, contact Apple Support or email us.

Does Forked support VoiceOver?

Yes. Forked is built with WCAG 2.1 AA accessibility standards. All interactive elements have VoiceOver labels and actions, text scales with Dynamic Type, animations respect Reduce Motion, and all colors meet minimum contrast ratios.

Do my profiles sync across devices?

Yes. Chef Profiles sync via iCloud Key-Value Store when iCloud is enabled on your device.

What data does Forked collect?

See the Forked Privacy Policy for full details.


Contact Support

For bug reports, feature requests, or questions: support@knownframe.com

We typically respond within a few days.