memos/docs/deploy-with-render.md
2023-03-18 23:07:40 +08:00

4.1 KiB

A Beginner's Guide to Deploying Memos on Render.com

written by AJ (also a noob)

✍️ memos

Live DemoOfficial WebsiteSource Code

Who is this guide for?

Someone who...

  • doesn't have much experience with self hosting
  • has a minimal understanding of docker

Someone who wants...

  • to use memos
  • to support the memos project
  • a cost effective and simple way to host it on the cloud with reliablity and persistance
  • to share memos with friends

Requirements

  • Can follow instructions
  • Have 7ish USD a month on a debit/credit card

Guide

Create an account at Render ss1

  1. Go to your dashboard

https://dashboard.render.com/

  1. Select New Web Service

    ss2

  2. Scroll down to "Public Git repository"

  3. Paste in the link for the public git repository for memos (https://github.com/usememos/memos) and press continue

    ss3

  4. Render will pre-fill most of the fields but you will need to create a unique name for your web service

  5. Adjust region if you want to

  6. Don't touch the "branch", "root directory", and "environment" fields

    ss4

  7. Click "enter your payment information" and do so

    ss5

    ss6

  8. Select the starter plan ($7 a month - a requirement for persistant data - render's free instances spin down when inactive and lose all data)

  9. Click "Create Web Service"

ss7

  1. Wait patiently while the magic happens 🤷‍♂️

ss8

  1. After some time (~ 6 min for me) the build will finish and you will see the web service is live

ss9

  1. Now it's time to add the disk so your data won't dissappear when the webservice redeploys (redeploys happen automatically when the public repo is updated)

  2. Select the "Disks" tab on the left menu and then click "Add Disk"

ss10

  1. Name your disk (can be whatever)

  2. Set the "Mount Path" to /var/opt/memos

  3. Set the disk size (default is 10GB but 1GB is plenty and can be increased at any time)

  4. Click "Save"

    ss11

  5. Wait...again...while the webservice redeploys with the persistant disk

    ss12

  6. aaaand....we're back online!

    ss13

  7. Time to test! We're going to make sure everything is working correctly.

  8. Click the link in the top left, it should look like https://the-name-you-chose.onrender.com - this is your self hosted memos link!

    ss14

  9. Create a Username and Password (remember these) then click "Sign up as Host"

    ss15

  10. Create a test memo then click save

    ss16

  11. Sign out of your self-hosted memos

    ss17

  12. Return to your Render dashboard, click the "Manual Deploy" dropdown button and click "Deploy latest commit" and wait until the webservice is live again (This is to test that your data is persistant)

    ss18

  13. Once the webservice is live go back to your self-hosted memos page and sign in! (If your memos screen looks different then something went wrong)

  14. Once you're logged in, verify your test memo is still there after the redeploy

    ss19

    ss20

🎉Celebrate!🎉

You did it! Enjoy using memos!

Want to learn more or need more guidance? Join the community on telegram and discord.