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.

Joplin logo

Self-host Joplin

v3.7.22

Privacy-focused note app with end-to-end encryption and sync

ReleaseOpen CoreOther
Updated2 weeks ago
LanguageTypescript
Setup difficultyModerate
MobileNative app
Stars
57 196
Ports
22300 (Joplin Server HTTP API), 4567 (Transcribe server)
Docker
joplin/server
Install with Docker
Multimedia notes with images and rich contentCollaboration features with shared notebooksWeb Clipper saving web pages as notesCustomization with plugins and themes

What is Joplin?

Joplin is a free, open-source note-taking and to-do application that handles many notes organized into notebooks. Notes use Markdown format, are searchable, and can be tagged and modified. The app works offline-first so notes are always accessible. Synchronization uses end-to-end encryption with cloud services. A self-hosted Joplin Server is available for organizations wanting full data control. The application runs on Windows, macOS, Linux, Android, iOS, and as a terminal app. A Web Clipper browser extension saves web pages and screenshots. The app supports plugins, custom themes, and multiple text editors.

Should you self-host Joplin?

Joplin scores 83/100 on selfhost.directory (how scoring works) and ranks #3 of 83 in Notes & Editors. It has 57 196 GitHub stars, +507 in the last 30 days.

It shipped 18 stable releases in the past year. The latest, v3.7.22, came out on 28 October 2026. New versions land roughly every 6 days.

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

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

Features

  • End-to-end encryption
  • Evernote import
  • External editor support
  • Full-Text Search
  • Multi-device synchronization
  • Multimedia Notes
  • Plugin System
  • Terminal application
  • Web Clipper

Joplin README

Donate using PayPal Sponsor on GitHub Become a patron Donate using IBAN

Joplin is a free, open source note taking and to-do application, which can handle a large number of notes organised into notebooks. The notes are searchable, can be copied, tagged and modified either from the applications directly or from your own text editor. The notes are in Markdown format.

How to install Joplin

Install Joplin with Docker

Environment variables
APP_BASE_URL, DB_CLIENT, POSTGRES_PASSWORD, POSTGRES_DATABASE, POSTGRES_USER, POSTGRES_PORT, POSTGRES_HOST, STORAGE_DRIVER

docker run --env-file .env -p 22300:22300 joplin/server:latest

For Joplin Server self-hosting

Joplin releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How do I restart Joplin on Windows (so that certain changes take effect)?

Close Joplin properly by clicking File > Quit or right-clicking tray icon > Exit. Task Manager can verify if Joplin is still running.

How can I use self-signed SSL certificates on Android?

Generate a custom CA and sign certificates with it using openssl or mkcert. Add the CA certificate to Android settings so Android recognizes the certificates as valid.

Why did my sync and encryption passwords disappear after updating Joplin?

On M1 Macs, version 2.12+ causes loss of keychain access from older versions. Re-enter passwords to fix sync and encryption issues.

Could there be a password to restrict access to Joplin?

On mobile, enable biometric lock. Desktop does not currently support this feature (open issue exists).

Is it possible to use real file and folder names in the sync target?

No, Joplin sync format is designed for performance and reliability, not user-friendliness. The sync directory is essentially a database.

How can I check the sync status?

Go to Help > Synchronisation Status on desktop, or Configuration > Tools > SYNC STATUS on mobile. Compare total items vs synced items.

Not all notes, folders, or tags are displayed on the mobile app

Joplin does not have background sync on mobile devices. Sync is interrupted when the app is closed, sent to background, or device sleeps.

The initial sync is very slow, how can I speed it up?

Large imports (e.g., from Evernote) can take a long time for initial sync. Various techniques to speed this up are outlined in the community forum.

I deleted some notes by accident and don't have a backup

If note history is enabled, use restoreNoteRevision command with the NOTE_ID. Find NOTE_ID in the SQLite database in deleted_items or revisions tables.

All my notes got deleted after changing the WebDAV URL!

When changing WebDAV URL, ensure the new location has the exact same content. Backup data, sync one last time, copy all Joplin files including .resource directory to new location, then change URL and sync.

How can I edit my note in an external text editor?

Configure the editor command in Preferences > Text editor command. Examples: 'subl -n -w' for Sublime, 'code -n --wait' for VS Code, 'gedit --new-window' for Gedit, 'xterm -e vim' for Vim in terminal.

Desktop application will not launch on Linux

If using AppImage directly, ensure execution permissions are set. The system may need libfuse2 library which AppImages require to run.

How can I pass arguments to the Linux installation script?

Pass arguments to the installation script using: wget -O - https://raw.githubusercontent.com/laurent22/joplin/dev/Joplin_install_and_update.sh | bash -s -- --argument1 --argument2

Installer gets stuck on Windows

The installer may get stuck if the app was not uninstalled correctly. Clean up the leftover registry entry under HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Uninstall by finding the Joplin entry and deleting its folder.

More in Notes & Editors

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…