Software Mirrors
ProductsBlogs
AFFiNE v0.27.4

AFFiNE v0.27.4

AFFiNE, document editing, visual whiteboarding, and structured knowledge management. It supports local workspaces, cloud synchronization, collaboration, and self-hosting, allowing users to choose between storing data on their own devices or managing their own servers.
(4.8)

Developer

Toeverything

Category

Developer Tools

Operating System

Windows / macOS / Linux

Date Published

Fri Nov 20 2026

Review AFFiNE v0.27.4

AFFiNE is an open-source workspace that integrates document editing, visual whiteboarding, and knowledge management into one application. Designed as an alternative to tools like Notion and Miro, it brings together structured documents, databases, and free-form visual canvases within a unified environment.

Rather than treating documents and whiteboards as separate tools, AFFiNE utilizes a block-based architecture that enables content to flow seamlessly between different formats. Users can take notes, organize information, build databases, plan projects, and develop visual presentations—all within the same workspace.

AFFiNE also places a strong emphasis on local data storage, privacy, and self-hosting. The platform offers a desktop application, browser-based access, cloud synchronization, and the option to use one’s own server for users who desire greater control over their data.

Download AFFiNE v0.27.4 - Software Mirrors

AFFiNE v0.27.4 for Windows

affine-0.27.4-stable-windows-x64.nsis.exe | 162.72 MB

affine-0.27.4-stable-windows-x64.exe | 210.82 MB

affine-0.27.4-stable-windows-arm64.nsis.exe | 157.67 MB

affine-0.27.4-stable-windows-arm64.exe | 208.57 MB

AFFiNE v0.27.4 for macOS

affine-0.27.4-stable-macos-x64.zip | 196.65 MB

affine-0.27.4-stable-macos-x64.dmg | 165.95 MB

affine-0.27.4-stable-macos-arm64.zip | 186.64 MB

affine-0.27.4-stable-macos-arm64.dmg | 151.42 MB

AFFiNE v0.27.4 for Linux

affine-0.27.4-stable-linux-x64.zip | 193.31 MB

affine-0.27.4-stable-linux-x64.flatpak | 155.76 MB

affine-0.27.4-stable-linux-x64.deb | 158.09 MB

affine-0.27.4-stable-linux-x64.appimage | 182.98 MB

AFFiNE v0.27.4 Source Code

AFFiNE v0.27.4 Source code (zip)

AFFiNE v0.27.4 Source code (tar.gz)

AFFiNE v0.27.4 Release Notes:

1

What's new

Web & Editor

  • Improve byok model editing

  • Fix code block line number trigger

  • Fix journal can see trashed docs

Native Client

  • Improve OnoNote importor

  • Mac client can hide the tray icon after the window is closed

  • Fix Android client keyboard compatibility

Backend

  • Add support for GPT 5.6/Gemini 3.7

  • Improve stability for long records

  • Fix high memory usage during server-side GC

Breaking change

Starting from client version 0.27, only server at version 0.27 or higher are supported to connect and sync. Starting from server version 0.27, only clients at version 0.26 or higher are supported to connect and sync. Starting from server version 0.27, environment variables are no longer the server’s preferred source for reading configuration, and some environment variables are no longer available. Please refer to https://docs.affine.pro/self-host-affine/install/configuration to migrate the configuration to config.json. The BYOK feature is in an experimental stage and may need to be reconfigured when upgrading versions.

Features

Document Editor and Knowledge Management

AFFiNE provides a block-based document editor for creating notes, articles, meeting records, research documents, and knowledge bases.

Its editing environment supports different content blocks, including:

Documents can be connected through backlinks and references, making it easier to build interconnected knowledge bases instead of maintaining isolated notes.

The block-based architecture also allows content to be reused across different documents without having to duplicate everything.

Edgeless Whiteboard

One of AFFiNE's most distinctive features is its Edgeless Mode, which transforms a document into an unlimited spatial canvas.

Unlike traditional document editors that arrange content in a linear sequence, Edgeless Mode allows users to position blocks freely. This is useful for brainstorming, mind mapping, project planning, presentations, and visual research.

You can combine text, images, shapes, and other content blocks on the same canvas. Documents can also switch between Page Mode and Edgeless Mode while preserving their underlying content and reading order.

This integration makes AFFiNE particularly interesting for users who frequently move between structured writing and visual thinking.

Database and Project Management

AFFiNE includes a database system for organizing structured information.

It supports different ways to manage content, including:

Databases can be used for project tracking, task management, reading lists, research collections, and other structured workflows.

Its block-based design also allows database content to connect with regular documents and visual canvases.

Collections and Organization

Collections provide another way to organize documents and workspace content.

Users can group pages manually or use rules to create collections that automatically organize matching documents.

Page properties can include dates, progress indicators, checkboxes, text, links, and tags. These properties make it easier to filter and manage larger knowledge bases.

AFFiNE AI

AFFiNE includes AI-assisted features through its Copilot system.

Depending on the configured provider and available capabilities, AI can help with:

Self-hosted installations support Bring Your Own Key (BYOK), allowing workspace owners to configure supported AI providers rather than relying exclusively on a managed AI subscription.

Supported provider routes include OpenAI, Anthropic, Gemini, and FAL. Different operations have different provider requirements, and some features require server-side configuration or workspace indexing.

This flexibility is useful for users who want to choose their own AI provider and manage API credentials independently.

Local-First Workspaces

AFFiNE supports local workspaces that store data on the user's device.

This allows users to work without depending on a permanently available cloud account. For users who need synchronization across devices, cloud workspaces provide another option.

Its synchronization architecture uses CRDT-based technology to support collaborative editing and manage concurrent changes.

Users can choose between local storage, AFFiNE Cloud, and self-hosted deployments depending on their requirements.

Real-Time Collaboration

AFFiNE supports collaborative workspaces where multiple members can work on shared content.

Collaboration capabilities include shared documents, synchronized changes, workspace membership, and collaborative editing.

AFFiNE Cloud provides additional collaboration and synchronization services. Self-hosted deployments allow organizations to operate their own workspace infrastructure.

The exact availability of advanced collaboration and administration features depends on the deployment and edition.

Templates and Customization

AFFiNE provides templates for different workflows, helping users get started without building every workspace from scratch.

Templates can cover:

Its flexible block system also allows users to customize their own document and whiteboard layouts.

Import and Export

AFFiNE supports importing and exporting workspace content, making it easier to migrate information and maintain backups.

Users can work with supported document formats and export their content for use outside AFFiNE.

Workspace export and import are particularly important for local-first applications because they provide an additional way to manage data independently of a particular cloud service.

For larger self-hosted deployments, database and uploaded-file backups should also be maintained separately.

Self-Hosting

AFFiNE can be deployed on infrastructure controlled by the user or organization.

The official Docker Compose deployment includes the AFFiNE application, PostgreSQL, Redis, and supporting services.

Self-hosting provides control over:

It is particularly useful for teams that want a private knowledge-management platform without depending entirely on a third-party cloud service.

Desktop and Web Applications

AFFiNE provides desktop applications and browser-based access.

The desktop applications are available for Windows, macOS, and Linux. Browser access provides another way to work with AFFiNE without installing a dedicated desktop client.

This makes it suitable for individuals who prefer a native application as well as teams that want to access their workspace through a self-hosted web deployment.

Performance and Compatibility

AFFiNE is primarily developed using TypeScript, with Rust components supporting parts of its backend and native functionality. Its editor architecture is built around BlockSuite, a block-based editing toolkit developed by the same organization.

The application uses CRDT technology for collaborative data synchronization and supports local-first workflows.

Its major capabilities include:

The desktop application supports Windows, macOS, and Linux. Browser access is available through modern web browsers.

Self-hosting requires more resources than running the desktop application. The official documentation recommends at least four CPU cores and 2 GB RAM for basic deployments, with 4 GB RAM recommended for larger documents and more demanding workloads.

PostgreSQL is the primary database, while Redis provides caching, background-task processing, and synchronization infrastructure. Uploaded files also require persistent storage.

AFFiNE Community Edition is available under the MIT license, but the repository contains separately licensed Enterprise Edition backend components. Organizations should review the individual license files before modifying or deploying those components in production.

System Requirements

Desktop:

Self-hosted server:

Pros and Cons

Pros

Cons

How to Install

AFFiNE can be used through its hosted service, desktop applications, or a self-hosted deployment.

Install the Desktop Application

Download the appropriate installer from the official AFFiNE download page.

Available desktop platforms include:

Install the application, launch it, and create a local workspace or connect to an existing AFFiNE Cloud or self-hosted workspace.

Run AFFiNE with Docker Compose

Docker Compose is the recommended method for self-hosting AFFiNE.

First, create a deployment directory:

mkdir -p affine/config
cd affine

Download the official Compose configuration:

curl -L -o docker-compose.yml \
  https://github.com/toeverything/AFFiNE/releases/latest/download/docker-compose.yml

Download the example configuration:

curl -L -o config/config.json \
  https://github.com/toeverything/AFFiNE/releases/latest/download/config.json.example

Edit config/config.json and configure the server URL:

{
  "$schema": "https://github.com/toeverything/affine/releases/latest/download/config.schema.json",
  "server": {
    "name": "AFFiNE Self-hosted",
    "externalUrl": "https://affine.example.com"
  },
  "copilot": {
    "enabled": true,
    "byok": {
      "enabled": true
    }
  }
}

Replace the example domain with your actual deployment address.

Start the services:

docker compose up -d

Check the running containers:

docker compose ps

Once the services are ready, open your configured domain or visit:

http://localhost:3010

For the initial setup, visit the administration page:

http://localhost:3010/admin

Create the first administrator account and complete the setup.

Configure HTTPS and Backups

For public deployments, configure a reverse proxy with HTTPS before inviting users.

Make sure the following data is backed up:

Test the restore procedure before upgrading the deployment. AFFiNE's database schema and Compose configuration can change between releases, so review the upgrade documentation before replacing an existing installation.

Final Verdict

AFFiNE is a compelling open-source workspace for users who want document editing, visual whiteboarding, and knowledge management without maintaining separate applications for each workflow.

Its block-based architecture is its biggest advantage. The ability to move between structured documents, databases, and unlimited visual canvases makes it more flexible than a conventional note-taking application. Local-first storage and self-hosting also provide meaningful control over personal and organizational data.

The addition of AI features and BYOK support makes the platform even more versatile, particularly for users who want to integrate their preferred AI providers into their knowledge-management workflow.

However, AFFiNE is not without limitations. Its development is active, some capabilities are still evolving, and self-hosting requires a properly maintained server environment. Organizations should also understand the distinction between the MIT-licensed Community Edition components and separately licensed Enterprise components.

Overall, AFFiNE is an excellent choice for individuals, developers, researchers, and teams looking for a flexible alternative to Notion and Miro.

Sources


Comments on AFFiNE v0.27.4