# SiYuan

> A self-hosted, block-based notes app for your own knowledge base.

- Page: https://cgt.octabyte.io/templates/siyuan/
- Category: Docs & wikis
- Replaces: Notion and Obsidian
- Ease of use: Easy. Open the web address and type the access code Cloudgate created for you; there are no accounts to set up.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: AGPL-3.0-only
- Good for: One person who wants Notion-style notes with linked blocks and databases, in the browser
- Official website: https://b3log.org/siyuan/en/
- Documentation: https://github.com/siyuan-note/siyuan#docker-hosting
- Source code: https://github.com/siyuan-note/siyuan
- Last updated: 2026-11-20

## What is SiYuan?

Self-hosted SiYuan is a private, block-based notes app with backlinks, databases and flashcards, used in any browser as your personal knowledge base.

SiYuan is a free, open-source, block-based note-taking app for a personal knowledge base, and a self-hosted alternative to Notion and Obsidian. On your own server it runs in any web browser, protected by an access code, so your notes stay with you.

Every paragraph in SiYuan is a block you can link to, embed or find with search, and backlinks and a graph view show how your notes connect. Documents nest inside notebooks, and lists can become databases with table, Kanban and gallery views. There are also flashcards, PDF annotation, daily notes, templates and an optional AI helper that uses a model you choose. A freelance wedding photographer, for example, could keep a page for each couple with shot lists and timings, follow every booking on a Kanban board, and link supplier notes to the weddings they worked on.

The server version is for one person and works only in the browser: the SiYuan desktop and phone apps can't connect to it, and it can't export to PDF, HTML or Word. Paid options add syncing to other devices and cloud storage; you don't need them here.

Cloudgate installs SiYuan on a server Cloudgate provides or one you connect, gives it a secure web address and creates the access code you type to open it.

## What you can do with SiYuan

- **Link any paragraph**: Every paragraph is a block you can link to or embed elsewhere, with backlinks showing where it is used.
- **See how ideas connect**: A graph view draws your linked documents as a map you can explore.
- **Build databases**: Keep lists of clients, jobs or reading as a table, a Kanban board or a gallery, with filters and sorting.
- **Write in a clean editor**: Type Markdown and see it formatted straight away, with outlines, maths, charts, flowcharts and mind maps.
- **Learn with flashcards**: Turn notes into flashcards and review them on a spaced-repetition schedule.
- **Annotate PDFs**: Highlight PDFs and link your highlights into your notes.
- **Find anything fast**: Search every block across all your notebooks and save the searches you use often.
- **Ask AI for help**: Use AI writing and questions over your notes with an OpenAI-compatible model you choose and pay for.

## Replaces Notion and Obsidian

SiYuan does the same job as Notion and Obsidian. Here is what changes when you switch.

### What you gain

- Your notes stay on your own server and open in any browser
- Notion-style databases and Obsidian-style linking in one app
- The core app is free, with no per-member price
- Flashcards and PDF annotation are built in

### What is different

- It is for one person; there are no team accounts or shared editing like Notion
- The SiYuan desktop and phone apps can't connect to your server; you use it in the browser
- Notes are stored in SiYuan's own files, not as plain Markdown files like Obsidian
- The server version can't export to PDF, HTML or Word, or import Markdown files

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=siyuan

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. SiYuan itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up SiYuan.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is SiYuan free?

Yes, SiYuan is free and open source under the AGPL-3.0 licence, and the self-hosted version you use in a browser needs no paid plan. Some features are paid, mainly syncing to other devices and cloud storage; as of November 2026 the PRO features cost a one-time $64.

### Is SiYuan a good alternative to Notion?

Yes, for one person's notes. SiYuan has nested documents, blocks and databases with table, Kanban and gallery views, much like Notion, but it has no team permissions or shared live editing, and there is no direct import from Notion.

### Is SiYuan a good alternative to Obsidian?

Yes, if you want linked notes, backlinks and a graph view on your own server, reached from any browser. Unlike Obsidian, SiYuan keeps notes in its own file format rather than plain Markdown files, and adds databases and flashcards.

### How do I sign in to SiYuan the first time?

Open SiYuan's web address and type the access code Cloudgate generated, which is shown on the app's variables page. There are no usernames; every new browser asks for that code, and you can change it later in SiYuan's settings.

### Can I use the SiYuan desktop or phone app with my server?

No, the SiYuan desktop and phone apps can't connect to a self-hosted server. You use the server in a web browser instead.

### Can more than one person use SiYuan?

No, SiYuan is built for one person, with one access code and one workspace. Anyone who has the code sees and can change everything, so for a team wiki choose an app with separate accounts.

### Can I export my notes from SiYuan?

Not to PDF, HTML or Word from the server version, which also can't import Markdown files. Your notes stay in SiYuan's own format on your server.

### Do I need technical skills to run SiYuan?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up SiYuan and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for SiYuan?

No. When you deploy SiYuan, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.

### Can I move my data from Notion to SiYuan?

Most people export from Notion and import into SiYuan. The official guides at github.com walk through it.
