# Logseq Published January 1, 2026 · Updated August 10, 2026 Privacy-first knowledge base Category: Productivity · Free · Open source · Replaces Roam Research ($15/mo) · [Official website](https://logseq.com) ## Install with Homebrew `brew install --cask logseq` ## Quick take Logseq in August 2026 is still excellent for local-first outliner PKM, but you must consciously pick OG Markdown vs DB beta and accept sync/mobile caveats. Ideal for privacy-minded researchers who like daily journals; hop to Obsidian if you need boring reliability on phones first. Best for: Outliner-centric PKM users, Privacy-first researchers, Students building networked notes ## What is Logseq? — Complete Guide for Mac Users in 2026 Logseq is a privacy-first, open-source knowledge base and outliner for notes, tasks, journals and networked thought. Historically it stored graphs as local Markdown/Org files you can sync with Git, iCloud or Syncthing. It emphasises block-level references, daily journals, linked queries, whiteboards and plugins while keeping data on your device by default. By August 2026 Logseq is in a deliberate split: the classic file-based app (often called Logseq OG / Markdown mode) and the newer Database (DB) version that stores graphs in SQLite-backed DB graphs with gallery/kanban-style views, richer properties/tags and groundwork for real-time collaboration. The DB version is in beta; a new mobile app and RTC (real-time collaboration) sync are in alpha, with maintainers still warning that data loss is possible, use automated backups. Official Logseq Sync has long been a paid beta (~$5/month range for backers/supporters historically); self-hosted sync options continue to expand on the DB line. The desktop app remains free and open source on macOS, Windows and Linux. Development is active but polarising: some users praise DB performance, others feel Markdown workflows and plugin stability moved slower than Obsidian’s ecosystem during the transition. ## Features - **Outliner journals & block references.** Daily journals plus bidirectional block links make Logseq excel at meeting notes, research crumbs and Zettelkasten-style networks without forcing page-first hierarchy. - **Local-first Markdown / Org graphs (OG).** Classic graphs remain plain files on disk, great for Git versioning, plaintext backups and editor interoperability. Ideal when you refuse opaque databases. - **Database graphs (DB beta).** DB graphs add structured properties, classes/tags and views (gallery, kanban, calendar roadmap) with better large-graph performance. Beta status means backups are mandatory. - **Queries, whiteboards & plugins.** Advanced queries surface tasks and references; whiteboards support spatial thinking; a plugin ecosystem extends flashcards, agendas and themes, with DB compatibility still catching up for some plugins. - **Sync options (Sync beta, self-host, RTC alpha).** Logseq Sync remains a hosted paid beta for many users; DB work adds more dependable sync paths and self-hosted server URLs. RTC collaboration is alpha, treat as experimental multi-device editing. - **Cross-platform desktop (mobile rebuild in flight).** Desktop apps cover macOS/Windows/Linux. The DB-era mobile app is separately alpha (iOS first, Android later per project notes), plan mobile capture carefully during migration. ## How to Install Logseq on Mac Download Logseq for macOS from logseq.com or GitHub releases. Decide up front whether you are testing DB beta or staying on classic file graphs. Grant Files and iCloud permissions only as needed; enable Time Machine or another backup before enabling experimental sync. 1. **Install via Homebrew (Recommended).** For the easiest maintenance and updates, use Homebrew. Open your Terminal app and run the command: `brew install --cask logseq`. This ensures you get the correct version for your architecture (Intel or Apple Silicon). 2. **Direct Download via GitHub.** Alternatively, visit the official Logseq GitHub releases page. Download the `.dmg` file tailored for your chip (look for `arch64` for M1/M2/M3/M4 Macs or `x64` for Intel). Mount the disk image. 3. **Application Setup.** Drag the Logseq icon into your Applications folder. On the first launch, macOS Gatekeeper may verify the developer signature; click 'Open' to proceed. You will be prompted to grant permissions to access your Documents folder. 4. **Initialize Your Graph.** Upon launching, click 'Add new graph'. Choose a dedicated local folder (e.g., `~/Documents/Logseq Graph`). This is where all your Markdown files will live. Avoid putting this folder inside other sync folders (like Dropbox) initially to prevent conflict issues. ## Pros - Truly local-first and open source - Best-in-class outliner + block reference model - DB version improves structure and large-graph performance - Strong daily-journal GTD workflows - Active forum development updates through 2026 - Free core without forcing a subscription to take notes ## Cons - DB vs Markdown split confuses upgrades and plugins - Mobile and RTC still alpha; Sync history has frustrated users - Heavier learning curve than Apple Notes or simple Markdown apps - Obsidian’s plugin/mobile polish still wins many switchers - Beta DB graphs require diligent backups ## Deep dive: Logseq Architecture and Internals Logseq is a technical marvel that bridges the gap between static files and dynamic databases. Built using ClojureScript, it runs a Datalog database (DataScript) directly in the client (your Mac). This is what enables its powerful query capabilities. Unlike Obsidian, which largely parses files via regex/caching, Logseq parses your Markdown files and ingests them into this graph database in real-time. This architectural decision allows for granular block referencing, treating every bullet point as a database row, but it also introduces the challenge of keeping the text files and the database index in perfect sync. In 2026, the 'Logseq DB' version has entered beta, introducing a native database backend that reduces the reliance on constant file parsing for large graphs. The block model matters because each bullet carries a stable identifier that you can embed elsewhere; editing the transcluded copy updates the original, which is how researchers keep a single source of truth without copy-paste drift. Daily journals amplify that model: the prompt for today is always a blank outline, so meeting notes, stray ideas and task captures start in the same place before you link them into longer pages. Advanced queries are where the Datalog layer pays off, letting you pull something like every unfinished task tagged with a project and created in the past seven days without scanning files by hand. Whiteboards and the plugin marketplace fill the visual and extensibility gaps, though plugin authors are still migrating compatibility from classic Markdown graphs to DB graphs, so check a plugin's DB status before you rely on it for a course or client. For sync, classic graphs reward plain-file tools: a Git repository gives you history and conflict visibility, while iCloud or Syncthing works until two devices write the same page at once and produce a conflict copy. Database graphs shift that trade-off toward a hosted or self-hosted sync endpoint with structured properties, classes and view types such as gallery, kanban and calendar that make large collections faster to browse. Early testers report that DB graphs handle tens of thousands of blocks with less indexing lag than classic graphs, but the beta carries explicit backup warnings because schema migrations can still require a graph export and reimport. If you value boring reliability on iOS today or depend on Obsidian's larger plugin catalog, keep your daily driver in Logseq OG or Obsidian and treat DB as a second vault until real-time collaboration leaves alpha. The new mobile effort is a separate DB-oriented app currently in alpha on iOS, so most Mac users still capture on the phone with something else and import later rather than treating the phone as a primary editor. On Apple Silicon Macs running Tahoe 26.x, install the official build from logseq.com or GitHub releases, re-approve file and network access after any major OS upgrade and keep a Time Machine or Git backup before you open an important graph in the DB beta. Vendor release notes and the discussion forum at discuss.logseq.com remain the quickest confirmation when a fresh macOS point release appears. Practical setup tip: create a template for daily journals that links your active project pages, then rely on linked references and the graph view to surface backlinks instead of maintaining a separate index by hand. Keep one vault for trial, one for daily work. ## FAQ ### Is Logseq free? Yes for local use. The app is open source. Optional hosted sync/collaboration services may cost money; file-based sync via Git/iCloud can stay free. ### What is Logseq DB? The Database version stores graphs in a DB (SQLite-centred) instead of only Markdown files, enabling richer properties and views. It is beta in 2026; keep backups. ### Is Logseq abandoned? No. The team is actively shipping DB, mobile alpha and RTC alpha work. Some users still feel the pace of Markdown-mode polish lagged competitors. ### Logseq vs Obsidian in 2026? Choose Logseq for outliner/journal-native workflows and FOSS purity. Choose Obsidian for plugin breadth, Publish and more mature mobile/sync productisation. ### How do I sync Logseq on Mac? Options include Logseq Sync (paid beta), iCloud/Dropbox folders for OG graphs, Git, Syncthing or newer DB self-hosted sync URLs. Avoid simultaneous multi-device writes on dumb file sync without locks. ### Can I migrate Markdown graphs to DB? Migration paths exist in project docs, but treat conversion as a deliberate project with exports/backups, features and plugins differ between modes. ### Does Logseq work offline? Yes. Local graphs work fully offline; only hosted sync/RTC features need network. ### Is there a native iOS app? A new DB-oriented mobile app has been in alpha; classic mobile support has been a pain point. Verify current TestFlight/store status before relying on phone capture. ## Sources - [logseq/logseq GitHub – Database Version](https://github.com/logseq/logseq) - [Logseq OG vs DB FAQ thread](https://discuss.logseq.com/t/logseq-og-markdown-vs-logseq-db-sqlite/34608) - [Logseq official site](https://logseq.com/) - [Logseq alternatives analysis 2026](https://dessence.ai/blog/logseq-alternatives-after-stalled-development-2026) - [What's New with Logseq DB – May 16 2026](https://discuss.logseq.com/t/whats-new-with-logseq-db-may-16th-2026/35020) - [What's new with Logseq DB – April 26 2026](https://discuss.logseq.com/t/whats-new-with-logseq-db-april-26-2026/34977) - [Obsidian vs Logseq 2026 comparison](https://www.atlasworkspace.ai/blog/obsidian-vs-logseq) ## Related - [Raycast](https://bundl.run/apps/raycast) - [Notion](https://bundl.run/apps/notion) - [Obsidian](https://bundl.run/apps/obsidian) - [Loom](https://bundl.run/apps/loom) - [Linear](https://bundl.run/apps/linear-linear) - [Grammarly](https://bundl.run/apps/grammarly-desktop) - [Logseq vs Obsidian](https://bundl.run/compare/logseq-vs-obsidian) - [Logseq vs Notion](https://bundl.run/compare/logseq-vs-notion) - [Free alternative to Roam Research](https://bundl.run/https:/) ```json { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://bundl.run/#organization", "name": "Bundl.run", "url": "https://bundl.run", "logo": { "@type": "ImageObject", "url": "https://bundl.run/og-image.png", "width": 1200, "height": 630 }, "description": "The Ninite for Mac. Install all your essential Mac apps with one terminal command.", "sameAs": [ "https://github.com/abhiofficial/bundl-mac-setup", "https://x.com/bundlrun", "https://www.producthunt.com/products/bundl-run" ], "foundingDate": "2024", "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://bundl.run/faq" } }, { "@type": "WebSite", "@id": "https://bundl.run/#website", "name": "Bundl.run", "url": "https://bundl.run", "description": "The Ninite for Mac. Install all your essential Mac apps with one terminal command.", "publisher": { "@id": "https://bundl.run/#organization" }, "inLanguage": "en-US" }, { "@type": "Person", "@id": "https://bundl.run/authors/jordan-kim#person", "name": "Jordan Kim", "jobTitle": "Productivity & Workflow Analyst", "url": "https://bundl.run/authors/jordan-kim", "worksFor": { "@id": "https://bundl.run/#organization" }, "description": "Jordan Kim focuses on productivity software, system utilities, and workflow optimization tools. With a background in operations management and process improvement, Jordan evaluates how well applications integrate into daily workflows and enhance overall productivity. Jordan tests each tool across multiple use cases—from solo work to team collaboration—documenting setup complexity, learning curves, and long-term value. A certified project management professional with experience at Fortune 500 companies, Jordan brings rigorous methodology to software evaluation.", "knowsAbout": [ "Productivity Applications", "Note-Taking & Knowledge Management", "Task & Project Management", "Communication Tools", "System Utilities", "Workflow Automation" ], "image": "https://bundl.run/authors/jordan-kim.svg" }, { "@type": "BreadcrumbList", "@id": "https://bundl.run/apps/logseq#breadcrumb", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://bundl.run" }, { "@type": "ListItem", "position": 2, "name": "Apps", "item": "https://bundl.run/apps" }, { "@type": "ListItem", "position": 3, "name": "Logseq", "item": "https://bundl.run/apps/logseq" } ] }, { "@type": "WebPage", "@id": "https://bundl.run/apps/logseq", "url": "https://bundl.run/apps/logseq", "name": "Logseq for Mac", "description": "Privacy-first knowledge base", "isPartOf": { "@id": "https://bundl.run/#website" }, "publisher": { "@id": "https://bundl.run/#organization" }, "inLanguage": "en-US", "datePublished": "2026-01-01T00:00:00Z", "dateModified": "2026-08-10T13:34:04.000Z", "author": { "@id": "https://bundl.run/authors/jordan-kim#person" }, "mainEntity": { "@id": "https://bundl.run/apps/logseq#software" }, "breadcrumb": { "@id": "https://bundl.run/apps/logseq#breadcrumb" } }, { "@type": "SoftwareApplication", "@id": "https://bundl.run/apps/logseq#software", "name": "Logseq", "description": "Privacy-first knowledge base", "applicationCategory": "BusinessApplication", "operatingSystem": "macOS", "url": "https://bundl.run/apps/logseq", "image": { "@type": "ImageObject", "url": "https://img.logo.dev/logseq.com", "caption": "Logseq app icon for Mac" }, "sameAs": [ "https://logseq.com/", "https://formulae.brew.sh/cask/logseq" ], "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "review": { "@type": "Review", "author": { "@id": "https://bundl.run/authors/jordan-kim#person" }, "reviewBody": "Logseq in August 2026 is still excellent for local-first outliner PKM, but you must consciously pick OG Markdown vs DB beta and accept sync/mobile caveats. Ideal for privacy-minded researchers who like daily journals; hop to Obsidian if you need boring reliability on phones first." }, "about": { "@type": "Thing", "name": "Logseq", "description": "Privacy-first knowledge base" }, "isPartOf": { "@id": "https://bundl.run/#website" } }, { "@type": "Article", "@id": "https://bundl.run/apps/logseq#article", "headline": "Logseq for Mac — Full Review & Installation Guide 2026", "description": "Logseq in August 2026 is still excellent for local-first outliner PKM, but you must consciously pick OG Markdown vs DB beta and accept sync/mobile caveats. Ideal for privacy-minded researchers who like daily journals; hop to Obsidian if you need boring reliability on phones first.", "image": "https://img.logo.dev/logseq.com", "author": { "@id": "https://bundl.run/authors/jordan-kim#person" }, "publisher": { "@id": "https://bundl.run/#organization" }, "datePublished": "2026-01-01T00:00:00Z", "dateModified": "2026-08-10T13:34:04.000Z", "mainEntityOfPage": { "@type": "WebPage", "@id": "https://bundl.run/apps/logseq" }, "articleSection": "BusinessApplication", "speakable": { "@type": "SpeakableSpecification", "cssSelector": [ "h1", ".key-facts" ] }, "about": { "@type": "SoftwareApplication", "name": "Logseq", "url": "https://bundl.run/apps/logseq" }, "mentions": [ { "@type": "SoftwareApplication", "name": "Roam Research" } ] }, { "@type": "FAQPage", "@id": "https://bundl.run/apps/logseq#faq", "mainEntity": [ { "@type": "Question", "name": "Is Logseq free?", "acceptedAnswer": { "@type": "Answer", "text": "Yes for local use. The app is open source. Optional hosted sync/collaboration services may cost money; file-based sync via Git/iCloud can stay free." } }, { "@type": "Question", "name": "What is Logseq DB?", "acceptedAnswer": { "@type": "Answer", "text": "The Database version stores graphs in a DB (SQLite-centred) instead of only Markdown files, enabling richer properties and views. It is beta in 2026; keep backups." } }, { "@type": "Question", "name": "Is Logseq abandoned?", "acceptedAnswer": { "@type": "Answer", "text": "No. The team is actively shipping DB, mobile alpha and RTC alpha work. Some users still feel the pace of Markdown-mode polish lagged competitors." } }, { "@type": "Question", "name": "Logseq vs Obsidian in 2026?", "acceptedAnswer": { "@type": "Answer", "text": "Choose Logseq for outliner/journal-native workflows and FOSS purity. Choose Obsidian for plugin breadth, Publish and more mature mobile/sync productisation." } }, { "@type": "Question", "name": "How do I sync Logseq on Mac?", "acceptedAnswer": { "@type": "Answer", "text": "Options include Logseq Sync (paid beta), iCloud/Dropbox folders for OG graphs, Git, Syncthing or newer DB self-hosted sync URLs. Avoid simultaneous multi-device writes on dumb file sync without locks." } }, { "@type": "Question", "name": "Can I migrate Markdown graphs to DB?", "acceptedAnswer": { "@type": "Answer", "text": "Migration paths exist in project docs, but treat conversion as a deliberate project with exports/backups, features and plugins differ between modes." } }, { "@type": "Question", "name": "Does Logseq work offline?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Local graphs work fully offline; only hosted sync/RTC features need network." } }, { "@type": "Question", "name": "Is there a native iOS app?", "acceptedAnswer": { "@type": "Answer", "text": "A new DB-oriented mobile app has been in alpha; classic mobile support has been a pain point. Verify current TestFlight/store status before relying on phone capture." } } ], "isPartOf": { "@id": "https://bundl.run/apps/logseq" } } ] } ```