FAQ

Short answers to common Alexandria questions.

Where is my data stored?

In your workspace folder, as plain Markdown files with YAML frontmatter. Notes are date-partitioned under notes/YYYY/MM/DD/, with related tag links, media files, and trash kept alongside them in the workspace.

Do I need a database or an account?

No. Alexandria stores data on disk as files. There is no database requirement and no account requirement for local use.

Is Alexandria open source?

Not at the moment. You are welcome to use it and send feedback, but there is no public source repository link.

Which platforms are supported?

The CLI builds from source with Cargo. The desktop app currently targets Linux and is still in progress; there are no prebuilt downloads yet.

How do I back up my notes?

Back up the whole workspace with any file backup tool. Include notes/, media/, trash/, and preferences.json. See Backup.

Is sync secure? How does it work?

Sync is end-to-end encrypted and zero-knowledge. The self-hostable server stores ciphertext, an encrypted manifest, and token hashes, not your plaintext notes or keys. See Sync.

Can I import from Notion or save web articles?

Yes. The Notion importer can bring in exported pages and databases; see Imports. The fetcher can save web articles as tagged Markdown notes; see Fetcher.

How do tags and properties work?

Tags are notes that can organize other notes. Tags can also define typed properties that apply to tagged notes. Start with Concepts, then read Tagging.

How do I get help or report a bug?

Use the contact details on Report a bug and get help. Include steps to reproduce, expected versus actual behavior, and any relevant logs or screenshots.