Skip to main content
This guide follows the new dashboard (v2). There you start the install from Server status and install (서버 상태와 설치) under My server (내 서버) in the left menu, and the install wizard opens at make.magicmealkits.com/v2/deploy. If you are on the previous screen at make.magicmealkits.com/deploy, the buttons sit in slightly different places but the order is the same. The dashboard UI is in Korean, so each step gives the English meaning with the Korean label in parentheses.
You install Magic Meal Kits from the web app at make.magicmealkits.com. The install wizard deploys the Magic Meal Kits server into your own Google Cloud project. You own the server, the data, and the URL.

​
Prerequisites

A Magic Meal Kits plan

You need a Basic or Pro plan already purchased.

A Gmail account

Use the same Gmail account you bought the plan with and sign in to Google Cloud with.

A GCP project with billing

Finish Google Cloud signup and the billing check first.
Install with a regular Gmail account, not a Google Workspace account. The install wizard only supports the Google Cloud environment of a regular Gmail account. Your Make account and the other accounts you connect from Make can be Workspace accounts.

​
Deploy your server

The wizard has 4 steps, shown in the progress bar at the top: Account (계정), Project and server size (프로젝트와 서버 사양), Deploy (배포), and Done (완료). The previous screen had 5 steps; server size selection moved into the project step, and there is a new deploy confirmation dialog. On the Get started (시작하기) checklist on the dashboard’s first screen, this covers step 2 Connect Google Cloud and step 3 Install your server.
1

Sign in

At make.magicmealkits.com, click Sign in with Google and pick the Gmail account you bought the plan with. The sign-in screen is still in English.
Sign in with Google button on the Magic Meal Kits sign-in screen
Sign in with Google button on the Magic Meal Kits sign-in screen (zoomed in)

Zoomed in

Google account picker

Example screen. The real screen shows Magic Meal Kits here.

Google account picker (Zoomed in)

Zoomed in

If you sign in with an account that has no purchase, no plan shows up and you get Upgrade plan (요금제 업그레이드) instead of the install button. Sign out and sign back in with the account you bought the plan with.
2

Account: connect Google Cloud

Open Server status and install (서버 상태와 설치) under My server (내 서버) in the left menu. If you have no server yet, click Start install (서버 설치 시작) to open the Install server (서버 설치) screen, the install wizard. Start install (설치 시작) in step 3 of the Get started checklist opens the same screen. On your first visit a guide video pops up. You can close it; to see it again, click View guide (가이드 보기) at the top right. Click Connect with Google (Google로 연결).
Connect with Google button on the step 1 Account screen
Connect with Google button on the step 1 Account screen (zoomed in)

Zoomed in

On the Google permission screen, pick the same account you signed in with and click Allow. If you allow only some of the permissions, the project list won’t load or the deployment fails.
Checkbox on the Google Cloud permission consent screen

Example screen. The real screen shows Magic Meal Kits here.

Checkbox on the Google Cloud permission consent screen (Zoomed in)

Zoomed in

Tick the box next to the permission before you click Continue.
3

Account: check the connection

Check the connected email and the app (Basic or Pro), then click Continue (계속).
Continue button after checking the connected account
Continue button after checking the connected account (zoomed in)

Zoomed in

4

Project and server size: pick a project

Under GCP project (GCP 프로젝트), pick the project to install into. If you don’t have one, click Create new project (새 프로젝트 만들기); the name must be 6 to 30 lowercase letters, numbers, or hyphens. A new project takes a few minutes to show up in the list. If it isn’t there, wait a moment and click the refresh button at the top right.
GCP project picker on the step 2 screen
GCP project picker on the step 2 screen (zoomed in)

Zoomed in

5

Project and server size: billing check

As soon as you pick a project, the wizard checks its billing status. If you see Billing is enabled for this project (이 프로젝트에서 결제가 활성화되어 있습니다), move on.If you see Billing not enabled (결제가 활성화되지 않음), deployment is blocked. Click this project’s billing page (이 프로젝트의 결제 페이지) in the message, link a billing account, come back, and click Recheck billing status (결제 상태 다시 확인).
Link to this project's billing page on a project without billing
Link to this project's billing page on a project without billing (zoomed in)

Zoomed in

6

Project and server size: pick a size and deploy

Pick a server size (서버 사양) and click Deploy (배포). Starting on Free (무료) is fine; you can change it later on the My server (내 서버) screen. The server size is how big your server is; it is not your Magic Meal Kits plan (Basic, Pro).
Deploy button after picking a server size
Deploy button after picking a server size (zoomed in)

Zoomed in

Running Magic Meal Kits itself is free. Google Cloud bills infrastructure directly, with a generous free allowance. Actual cost depends on your usage and region.
7

Confirm the deployment

In the Deploy to Cloud Run? (Cloud Run에 배포할까요?) dialog, click Deploy (배포).
Deploy button in the confirmation dialog
Deploy button in the confirmation dialog (zoomed in)

Zoomed in

8

Deploy: wait

Building the server takes a few minutes. Keep the tab open while you wait. If a billing problem shows up at this point, you get a billing-required notice and go back to step 2.
Note on the deploy progress screen asking you to keep the tab open
Note on the deploy progress screen asking you to keep the tab open (zoomed in)

Zoomed in

9

Done

The Deployment complete (배포 완료) screen shows your service URL. Click View App Status (앱 상태 보기); it takes you to the My server (내 서버) screen.
View App Status button on the deployment complete screen
View App Status button on the deployment complete screen (zoomed in)

Zoomed in

10

Copy the API key from My server

On the My server (내 서버) screen, copy the key with the copy button next to API key (API 키) in the Access info (접속 정보) section. The server URL (서버 주소) is in the same section. You use both values in the first module test. Step 4 of the Get started checklist shows the same two values and a Check server (서버 응답 확인) button.
API key copy button on the App Status screen
API key copy button on the App Status screen (zoomed in)

Zoomed in

​
What gets set up

The installer provisions everything the server needs in your project:
  • Cloud Run service magic-meal-kits (region us-west1)
  • Firestore (default) database: jobs and sync state
  • BigQuery dataset threads_data: posts and replies storage for search
  • Secret Manager and Cloud Tasks
  • The required Google APIs and IAM roles, and a public (invokable) URL
It also sets these environment variables on the service:

​
After deploying

Your server URL and API key are shown in the Access info (접속 정보) section of the My server (내 서버) screen (App Status on the previous screen). You don’t configure them by hand; copy them from there.

Authentication

How the X-API-KEY header and license tiers work.

Quickstart

Make your first call to your deployment.

​
Upgrading (redeploy)

To move your server to the latest version, click Update (업데이트) at the top right of the My server (내 서버) screen (Redeploy on the previous screen), then confirm the redeploy in the dialog. The Version (버전) cell at the top of the same screen shows your current version, and the last install time is under the screen title. A redeploy upgrades the server you already have: it swaps the running container for the latest version and creates a new Cloud Run revision.
Redeploy button at the top right of the App Status screen
Redeploy button at the top right of the App Status screen (zoomed in)

Zoomed in

Redeploying does not lose data and does not change your URL or API key. Only the server version moves forward. There is no automatic update notice; update from the My server screen whenever you want.