selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

owlistic logo

Self-host owlistic

v0.2.0

Open-source real-time notetaking and todo app

AlphaOpen SourceGPL-3.0
Updated4 months ago
LanguageDart
Setup difficultyModerate
MobilePWA
ThemeDark mode
Stars
431
CPU
Dual-core CPU with a clock speed of 2.0 GHz or higher
RAM
4 GB of RAM
Storage
At least 500 MB of free disk space
Ports
8080 (backend API server), 80 (frontend web app)
Requires
NATS, PostgreSQL
Docker
ghcr.io/owlistic-notes/owlistic
Install with Docker
Real-time updates demo showing synchronization across devicesRich text editor with formatting toolbarEditor toolbar with formatting optionsHome screen with notebooks and notesSidebar navigationNotebooks viewTasks view with inline todos

What is owlistic?

Owlistic is a self-hosted notetaking and todo application built with Flutter (frontend) and Go (backend). It provides a WYSIWYG rich text editor for creating formatted notes, organizes notes into notebooks with a tree structure, supports inline todo items within notes, and synchronizes changes in real time across devices using NATS. The app includes JWT-based authentication with role-based access control, a trash bin for deleted items, dark and light themes, and markdown import. It can be deployed via Docker Compose (recommended), Docker, Kubernetes with Helm charts, or as a standalone binary. The backend requires PostgreSQL for data storage and NATS for real-time messaging. The project is licensed under GPL-3.0 and is under active development with pre-1.0 releases.

Should you self-host owlistic?

owlistic scores 44/100 on selfhost.directory (how scoring works) and ranks #56 of 81 in Notes & Editors. It has 431 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Dart.

Its closest alternative on selfhost.directory is Memos (86/100, 64 141 stars). It scores higher overall, so compare the two before you pick. See owlistic vs Memos side by side.

Features

  • Dark/light mode
  • Inline todo items
  • Markdown import
  • Notebooks and notes tree
  • Progressive Web App (PWA)
  • Real-time sync
  • Rich text (WYSIWYG) editor
  • Role-based Access Control
  • Trash bin

owlistic README

How to install owlistic

Install owlistic with Docker

Docker installed, PostgreSQL and NATS running
Environment variables
APP_PORT, DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME, BROKER_ADDRESS

Pull the server image

docker pull ghcr.io/owlistic-notes/owlistic:latest

Pull the app image

docker pull ghcr.io/owlistic-notes/owlistic-app:latest

Run the server

docker run -d
--name owlistic
-p 8080:8080
-e APP_PORT=8080
-e DB_HOST=postgres
-e DB_PORT=5432
-e DB_USER=admin
-e DB_PASSWORD=admin
-e DB_NAME=postgres
-e BROKER_ADDRESS=nats:4222
ghcr.io/owlistic-notes/owlistic:latest

Run the app

docker run -d
--name owlistic-app
-p 80:80
ghcr.io/owlistic-notes/owlistic-app:latest

Requires separate PostgreSQL and NATS containers

How to configure owlistic

  • APP_ORIGINSAllowed origins for CORS

    Allowed origins for CORS

  • BROKER_ADDRESSNATS broker address

    NATS broker address

  • DB_HOSTPostgreSQL host

    PostgreSQL host

  • DB_NAMEPostgreSQL database name

    PostgreSQL database name

  • DB_PASSWORDPostgreSQL password

    PostgreSQL password

  • DB_PORTPostgreSQL port

    PostgreSQL port

  • DB_USERPostgreSQL username

    PostgreSQL username

owlistic releases & version history

FAQ

How do I report a bug?

Open an issue on the GitHub repository with as much detail as possible.

Where can I find help if I encounter issues?

Check the Troubleshooting section for common problems and solutions, or reach out to the community through GitHub discussions.

How can I contribute to the project?

Contributions are welcome. Read the Contributing guidelines for information on how to get involved.

What is this Owlistic?

Owlistic is a self-hosted solution designed to help users manage their notes and tasks efficiently with features like WYSIWYG editor, inline todo items, and synchronization across devices.

More in Task Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…