Managed Hosting

The below services can be used to host memos, if you don't administer your own server.

• Render.com
• Fly.io
  • Prerequisites
  • Install flyctl
  • Launch a fly application
  • Edit your fly.toml
    • Details of manual modifications
      • 1. Add a build section.
      • 2. Add an env section.
      • 3. Configure litestream backups
      • 4. Add a persistent volume
      • 5. Change internal_port in [[services]]
      • 6. Deploy to fly.io
• PikaPods.com

Render.com

Create an account at Render

1. Go to your dashboard

https://dashboard.render.com/

1. Select New Web Service

   

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

   

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

   

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

   

   

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"

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

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

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"

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"

   

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

   

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

   

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!

   

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

   

10. Create a test memo then click save

    

11. Sign out of your self-hosted memos

    

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)

    

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

    

    

Fly.io

provided by @hu3rror/memos-on-fly on GitHub

Prerequisites

• fly.io account
• backblaze account or other B2 service account
• [Optional] If you want to build your own docker image, clone repository from hu3rror/memos-on-fly-build.

Install flyctl

1. Follow the instructions to install fly's command-line interface flyctl.
2. log into flyctl.

flyctl auth login

Launch a fly application

do not setup Postgres and do not deploy yet!

flyctl launch

This command creates a fly.toml file.

Edit your fly.toml

You can take fly.example.toml in this repository as a reference and modify according to the comments.

Details of manual modifications

1. Add a build section.

[build]
  image = "ghcr.io/hu3rror/memos-litestream:latest"

2. Add an env section.

[env]
  DB_PATH = "/var/opt/memos/memos_prod.db"  # do not change
  LITESTREAM_REPLICA_BUCKET = "<filled_later>"  # change to your litestream bucket name
  LITESTREAM_REPLICA_ENDPOINT = "<filled_later>"  # change to your litestream endpoint url
  LITESTREAM_REPLICA_PATH = "memos_prod.db"  # keep the default or change to whatever path you want

3. Configure litestream backups

ℹ️ If you want to use another storage provider, check litestream's "Replica Guides" section and adjust the config as needed.

1. Log into B2 and create a bucket. Instead of adjusting the litestream config directly, we will add storage configuration to fly.toml.
2. Now you can set the values of LITESTREAM_REPLICA_ENDPOINT and LITESTREAM_REPLICA_BUCKET to your [env] section.
3. Then, create an access key for this bucket. Add the key to fly's secret store (Don't add < and >).

   flyctl secrets set LITESTREAM_ACCESS_KEY_ID="<keyId>" LITESTREAM_SECRET_ACCESS_KEY="<applicationKey>"
   

4. Add a persistent volume

1. Create a persistent volume. Fly's free tier includes 3GB of storage across your VMs. Since memos is very light on storage, a 1GB volume will be more than enough for most use cases. It's possible to change volume size later. A how-to can be found in the "scale persistent volume" section below.

   flyctl volumes create memos_data --region <your_region> --size <size_in_gb>
   

   For example:

   flyctl volumes create memos_data --region hkg --size 1
   

2. Attach the persistent volume to the container by adding a mounts section to fly.toml.

   [[mounts]]
      source = "memos_data"
      destination = "/var/opt/memos"
      processes = ["app"]
   

5. Change internal_port in [[services]]

[[services]]
  internal_port = 5230

6. Deploy to fly.io

flyctl deploy

If all is well, you can now access memos by running flyctl open. You should see its login page.

If the latest docker image has been released, you can easily upgrade the memo by typing flyctl deploy in your memos project's folder.

PikaPods.com

Privacy-focused one-click hosting for open source apps. EU and US regions available. Run memos from $1/month with $5 free welcome credit.