Skip to content

Latest commit

 

History

History
90 lines (65 loc) · 3.26 KB

one-click-deploy.md

File metadata and controls

90 lines (65 loc) · 3.26 KB

Deploy Maybe in One Click

Below are our "one-click deploy" options for running Maybe in the cloud:

Render

Welcome to the one-click deploy guide for Maybe on Render!

Render is a hosting platform with a generous free tier and makes it easy to get started with Maybe:

  • Getting started is FREE
  • Up and running in <5 minutes
  • Your Maybe app is automatically deployed to a live URL

Estimated Costs

  • FREE to get up and running
  • $7 per month for a basic app (Render requires you to upgrade your database to keep using it)
  • $14+ per month for optimal performance

IMPORTANT: if you plan to host Maybe on Render long-term, you MUST upgrade your database to a paid Render service.

Instructions

Step 1: Create Render Blueprint

Deploy to Render
  1. Click the button above.
  2. Sign in or create your account with Render (FREE)
  3. Give your blueprint a name (we suggest Maybe)
  4. Select the main branch
  5. You should see a section at the bottom with a "Key:Value" field for SECRET_KEY_BASE. Do NOT click "generate".
  6. On your computer, open a terminal and make sure you have the openssl utility installed on your computer. You can run openssl --version to verify it is installed.
  7. Generate your SECRET_KEY_BASE by running the following command in your terminal: openssl rand -hex 64 (docs).
  8. Do NOT share this value with anyone.
  9. Go back to your browser and paste this value in the "Value" field for SECRET_KEY_BASE
  10. Click "Apply". This will take a few minutes.
  11. Once complete, click on the maybe "Web Service". You should see a custom URL in the format https://maybe-abcd.onrender.com. Click on it, and you'll see your running Maybe app!

Step 2: Add your deploy hook for auto-updates

To get new releases, you will need to add your deploy hook to the app.

  1. Click on the maybe "Web Service"
  2. Click "Settings"
  3. Scroll down to the end of the "Build and Deploy" section until you find the " Deploy Hook"
  4. Copy this value
  5. Open your new Maybe app, click your profile, click "Self Host Settings"
  6. Paste your deploy hook in the settings and save
  7. You're all set!

Step 3 (IMPORTANT!!!): Upgrade your Render services

By default, we set you up with a FREE Render web service and a FREE postgres database. We do this for a few reasons:

  • It allows you to take self-hosted Maybe for a FREE test-drive
  • It prevents newcomers from incurring unexpected hosting charges
Upgrade your Database (REQUIRED)

All FREE Render databases will be deleted after a few months. This means that you will lose all of your Maybe data.

To avoid losing data, you MUST upgrade your Render database (a "starter" instance is $7/month)

You can upgrade your instance directly in the Render dashboard.

Upgrade your Web Service (RECOMMENDED)

All FREE Render web services use a small amount of memory and "sleep" after periods of inactivity.

For the fastest Maybe experience, you should upgrade your web service (a " starter" instance is $7/month)