English | 中文

Diarum (Chinese: 吾身) - A simple, elegant, and self-hosted diary application built with PocketBase and modern web technologies.

Desktop Light	Desktop Dark

Mobile Light	Mobile Dark

• 📝 Markdown Support - Write your daily thoughts with full Markdown formatting
• 🖼️ Media Upload - Attach images and files to your diary entries, with Chevereto image hosting support for flexible switching between built-in media manager and external image hosting
• 📱 Progressive Web App - Install on any device with offline support and app-like experience
• 📤 One-Click Share - Share your diary entries instantly with a single tap
• 🔄 Offline & Auto Sync - Work offline seamlessly with automatic cache synchronization and real-time sync status monitoring
• 🔒 Self-Hosted - Complete control over your personal data
• 🚀 Easy Deployment - Single binary with embedded frontend, deploy anywhere
• 💾 PocketBase Backend - Reliable database with built-in admin panel
• 🔧 Configurable - Flexible data directory configuration via environment variables or CLI flags

docker run -d \
  --name diarum \
  -p 8090:8090 \
  songtianlun/diarum:latest

Access the application at http://localhost:8090

To persist your diary data, mount a volume to the data directory:

docker run -d \
  --name diarum \
  -p 8090:8090 \
  -v /path/to/your/data:/app/data \
  songtianlun/diarum:latest

Create a docker-compose.yml file:

version: '3.8'

services:
  diarum:
    image: songtianlun/diarum:latest
    container_name: diarum
    ports:
      - "8090:8090"
    volumes:
      - ./data:/app/data
    environment:
      - DIARUM_DATA_PATH=/app/data
    restart: unless-stopped

Run with:

docker compose up -d

You can configure the data directory in three ways (in order of priority):

1. Command Line Flag:

   ./diarum serve --data-dir=/custom/path

2. Environment Variable:

   export DIARUM_DATA_PATH=/custom/path
   ./diarum serve

3. Default: ./pb_data (current directory)

• DIARUM_DATA_PATH: Set the data directory path (default: /app/data)

• Go 1.22 or higher
• Node.js 20 or higher

# Clone the repository
git clone https://github.com/songtianlun/diarum.git
cd diarum

# Build frontend
cd site
npm install
npm run build
cd ..

# Build backend
go build -o diarum .

# Run
./diarum serve

Or use the Makefile:

make build
./diarum serve

# Run with auto-reload (requires air)
make dev

# Build Docker image
make docker-build

# Run tests
make test

Access the PocketBase admin panel at http://localhost:8090/_/ to:

• Manage database collections
• Configure authentication
• View logs
• Customize settings

吾身 (Diarum) - 取自"吾日三省吾身"，一款零负担、快记录、怡复盘的日记应用，记录独一无二的人生。

零负担，软件使用非常简单，登陆后打开首页即跳转到今日日记。快记录，打开立刻开始记录，自动保存。怡复盘，可以愉快的完成复盘、总结分析。轻松实现现代化 AI 加持的“吾日三省吾身”。

配置 AI Key 之后自动触发日记向量化，后续可以跟 AI LLM 结合日记开展对话 。自然快速地完成：

• 今日复盘
• 周报生成
• 年终总结
• 等等

基于 PocketBase 和现代 Web 技术构建，简洁、优雅、可自托管。

开发这款软件的初衷源自自己对日记的需求。现在市面上已经有很多优秀的日记和笔记软件。但都多少有点无法满足自己的需求。我期望的一个日记软件，是打开后立刻可以开始记录，不需要纠结文件名、标题、目录结构。最好是网页的，这样在各种设备都可以使用。我自己的设备涉及 MacBook 、HarmonyOS NEXT 、Android 、Arch Linux 、Windows 。只有网页应用能够很好的快速兼容这些平台。最好是可以很方便的自托管的，确保我自己对数据的掌控，且方便搬家。

于是就做了这样一款软件，英文名叫 Diarum ，中文名叫 “吾身”。使用 go+svelte 开发，轻快好用。花费了大量心思打磨移动端和桌面端的日记体验。现在我个人感觉使用体验已经比较丝滑，可以愉快的记录一天的各种事情。

在核心功能的基础上，集成了一个简单的 RAG 系统，配置好 AI KEY 和 MODEL 之后，会自动触发向量数据库的构建。这样一来跟内置的 AI 助手对话时，就可以将向量匹配到的日记放入上下文，方便的进行分析总结等。此外还提供了一个简单的 API 系统，可以方便的将日记数据对接到 n8n 这样的平台，实现自动化的周报、月报生成等灵活的工作流。

桌面端浅色	桌面端深色

移动端浅色	移动端深色

• 📝 Markdown 支持 - 使用完整的 Markdown 格式记录每日想法
• 🖼️ 媒体上传 - 为日记条目添加图片和文件，支持 Chevereto 图床，灵活切换内置媒体管理器或外部图床
• 📱 渐进式 Web 应用 - 支持安装到任意设备，离线可用，原生应用般的体验
• 📤 一键分享 - 轻点即可分享日记内容
• 🔄 离线与自动同步 - 完整离线支持，自动缓存同步，实时查看数据同步状态
• 🔒 自托管 - 完全掌控你的个人数据
• 🚀 易于部署 - 单一二进制文件，内嵌前端，随处部署
• 💾 PocketBase 后端 - 可靠的数据库和内置管理面板
• 🔧 可配置 - 通过环境变量或命令行参数灵活配置数据目录

docker run -d \
  --name diarum \
  -p 8090:8090 \
  songtianlun/diarum:latest

在浏览器访问 http://localhost:8090

要持久化你的日记数据，需要挂载数据卷到数据目录：

docker run -d \
  --name diarum \
  -p 8090:8090 \
  -v /path/to/your/data:/app/data \
  songtianlun/diarum:latest

创建 docker-compose.yml 文件：

version: '3.8'

services:
  diarum:
    image: songtianlun/diarum:latest
    container_name: diarum
    ports:
      - "8090:8090"
    volumes:
      - ./data:/app/data
    environment:
      - DIARUM_DATA_PATH=/app/data
    restart: unless-stopped

运行：

docker compose up -d

你可以通过三种方式配置数据目录（优先级从高到低）：

1. 命令行参数：

   ./diarum serve --data-dir=/custom/path

2. 环境变量：

   export DIARUM_DATA_PATH=/custom/path
   ./diarum serve

3. 默认值：./pb_data（当前目录）

• DIARUM_DATA_PATH：设置数据目录路径（默认：/app/data）

• Go 1.22 或更高版本
• Node.js 20 或更高版本

# 克隆仓库
git clone https://github.com/songtianlun/diarum.git
cd diarum

# 全量构建
make build

# 运行
./diarum serve

# 启动前端开发服务器
make dev-frontend

# 启动后端开发服务器
make dev-backend

访问 http://localhost:8090/_/ 打开 PocketBase 管理面板，可以：

• 管理数据库集合
• 配置身份验证
• 查看日志
• 自定义设置

Contributions are welcome! Please feel free to submit a Pull Request.

If you encounter any issues or have questions, please open an issue.

Made with ❤️ by songtianlun