Skip to content

Latest commit

 

History

History
82 lines (75 loc) · 2.45 KB

README.md

File metadata and controls

82 lines (75 loc) · 2.45 KB

MemoDown

A simple knowledge management web application supports markdown, powered by blazor.

Features

  • Full markdown support powered by cherry-markdown
  • Simple and Clean UI
  • Plain markdown files are supported
  • Images are supported, uploading or external
  • Saving all resources to local file system
  • Multiple level hierarchy sidebar
  • Automatically saving
  • Sync to Github

Usage

Build from source

  • For Windows
dotnet build -c Release -r win-x64 --self-contained true
  • For Linux
dotnet build -c Release -r linux-x64 --self-contained true

Configurations

  "MemoDown": {
  "MemoDir": "/path/to/markdown", // default to C:\Users\[UserName]\memo on Windows or /home/memo on Linux
  "AutoSavingIntervalSecond": 30,
  "UploadsDir": "/path/to/uploads", // default to [MemoDir]/uploads
  "UploadsVirtualPath": "request virtual path for uploads", // default to uploads
  "CleanUploadsAt": "0 1 * * *", linux cron expression, better before AutoSyncAt
  "Account": {
    "UserName": "your user name",
    "Password": "your password hash"
  },  
  "CloudflareTurnstile": {
    "Enable": false,
    "SiteKey": "your turnstile SiteKey",
    "SecretKey": "your turnstile SecretKey"
  },
  "Github": {
    "Enable": false,
    "PAT": "your Personal Access Token",
    "RepoName": "your repo to sync to",
    "RepoOwner": "owner name of the repo",
    "Branch": "branch name", // default to main
    "EnableAutoSync": false,
    "AutoSyncAt": "0 2 * * *" // linux cron expression
  }
}

you may need the password-hasher to hash your password

Using docker

  • Create builder for cross-platform docker building (optional)
docker buildx create --driver-opt default-load=true --name=container --use
docker buildx inspect --bootstrap container
  • Build docker image (optional)

    • Push to docker hub
      docker buildx build --platform=linux/amd64,linux/arm64 --push --builder=container -t balder1840/memo-down:v1.0.1 .
    • Or load to local
      docker buildx build --platform=linux/amd64 --load --builder=container -t balder1840/memo-down:v1.0.1 .
  • Use the image

  docker run -d \
  --name memodown \
  -p 8080:8080 \
  -e MemoDown__Account__UserName=your_user_name \
  -e MemoDown__Account__Password=your_password_hash \
  -v ~/memo:/memo \
  balder1840/memo-down:tagname \