Skip to content

Install and First Connection

1. Install the app

  • Go to download page: Download MemoFlow
  • Choose your preferred distribution channel on the download page (Google Play or F-Droid)
  • Current releases focus on Android; iOS is still in planning

2. Prepare connection info

Before opening the login page, prepare these three items:

  1. Memos server address (for example https://your-memos.example.com).
  2. Login credential (choose one):
    • Username + password
    • Personal Access Token (PAT)
  3. Server version (login page supports selecting 0.21.0 to 0.26.0).

3. Fill the login page

There are four key fields:

  1. Login mode: switch between Password and Token.
  2. Server URL: enter root URL only. Do not manually append /api/....
  3. API version: select the server version from dropdown.
  4. Click Connect.
Login page overview

4. Connection validation behavior (as implemented)

  • Token login: runs API-version probe on selected version first, then enters session.
  • Password login: signs in first, then runs selected-version probe.

If probe fails, the page shows a diagnostics panel (copyable), useful for identifying version mismatch vs server endpoint issues.

5. First-connection verification

After login, run this quick 60-second verification:

  1. Open memo list and wait for first data load.
  2. Create one test memo (for example: "connection test").
  3. Pull to refresh once and confirm it is still visible.
  4. Confirm the same memo exists on the server side.

6. Two useful details

  • If URL is entered with /api/v1, the app normalizes it back to root URL and prompts.
  • In token mode, pasting values with Bearer prefix is supported; prefix and extra spaces are auto-cleaned.