> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magicmealkits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Keep your Magic Meal Kits deployment running: Google Cloud billing, stopping/reinstalling the service, and what to do when the server is slow to come back.

These notes apply to **every** Magic Meal Kits deployment (all apps — Threads, Plaud,
Notion, …), since the server runs in your own Google Cloud project.

**Start here when something's wrong** — pick the symptom that matches.

### Server stopped or erroring

<CardGroup cols={2}>
  <Card title="Free trial ended / activate billing" icon="credit-card" href="/operations/google-cloud-billing">
    Your Google Cloud free trial ended and the server stopped — upgrade (activate billing).
  </Card>

  <Card title="Modules keep returning 503" icon="triangle-exclamation" href="/operations/fix-503-force-sync">
    Make scenarios repeatedly fail with `503` — force-reactivate the server.
  </Card>

  <Card title="Notion 401 / permission error" icon="lock" href="/operations/notion-connection">
    Notion modules fail with `401` or a permission error — grant access and re-set the connection.
  </Card>
</CardGroup>

### Tuning & maintenance

<CardGroup cols={2}>
  <Card title="Server is slow / out of memory" icon="gauge-high" href="/operations/upgrade-performance">
    Slow under heavy load — upgrade the memory tier from Free to Basic.
  </Card>

  <Card title="Building Make scenarios" icon="puzzle-piece" href="/operations/make-integration-tips">
    Find the modules, set timeouts, and avoid duplicate runs in Make.com.
  </Card>

  <Card title="Support asked for logs" icon="file-arrow-down" href="/operations/share-system-logs">
    Download your system logs from Google Cloud and send them to support.
  </Card>

  <Card title="Stop or reinstall" icon="power-off" href="/operations/stop-reinstall">
    Stop the service, or reinstall it (with the billing prerequisite).
  </Card>
</CardGroup>

## Keeping your deployment running

The Magic Meal Kits server runs in **your own Google Cloud project** and stays within
Google Cloud's free usage tier for normal use — but the **free trial is time-limited**.

<Warning>
  If you started on the Google Cloud **free trial**, your server is **stopped once the trial
  ends** unless you **activate billing (upgrade)** first. See
  [Activate Google Cloud billing (upgrade)](/operations/google-cloud-billing) for the
  step-by-step guide and what it costs.
</Warning>

## Stopping or reinstalling the service

You can stop and reinstall the Magic Meal Kits service at any time:

1. Sign in to Google Cloud at [make.magicmealkits.com/google-connection](https://make.magicmealkits.com/google-connection).
2. Open [make.magicmealkits.com/app-status](https://make.magicmealkits.com/app-status).
3. Click **Stop Service** and type `magic-meal-kits` to confirm.

Full step-by-step guide:
[Stop or reinstall the service](/operations/stop-reinstall).

<Warning>
  **Reinstalling requires a healthy Google Cloud billing account.** If your Google Cloud
  billing has an issue, the installation will fail — you must resolve the billing problem
  first, then reinstall. If you can't verify the billing status, the cleanest path is to
  **fully delete and reinstall** after fixing billing.
</Warning>

<Note>
  **After fixing billing or reinstalling, give it 20–30 minutes — don't redeploy
  repeatedly.** When a server has been down for a while and you reinstall or correct your
  billing info, the service often does **not** respond right away: you may see `503`
  (cold start) or `429` (Rate exceeded) for a time. This is normal warm-up / propagation
  and usually clears on its own within **20–30 minutes**. Please just wait — repeatedly
  redeploying does not speed it up and can make recovery take longer.
</Note>