Levelrail
Skip to content

Self-host Joplin Server with Docker ​

A self-hosted sync target for the Joplin note-taking app, replacing Dropbox or OneDrive sync.

This page describes the Levelrail template for Joplin Server (Productivity). It deploys the services below as one Docker Compose app on your own server.

Project site: https://joplinapp.org/help/api/server_config/.

Recommended memory: about 256 MiB.

Services, ports and volumes ​

ServiceImageContainer portsVolumes
dbpostgres:16none
joplin_db_data -> /var/lib/postgresql/data
joplinjoplin/server:3.7.222300none

Environment variables ​

ServiceVariableValue
dbPOSTGRES_DBPreset in the template
dbPOSTGRES_PASSWORDGenerated at deploy
dbPOSTGRES_USERPreset in the template
joplinAPP_BASE_URLPreset in the template
joplinDB_CLIENTPreset in the template
joplinPOSTGRES_DATABASEPreset in the template
joplinPOSTGRES_HOSTPreset in the template
joplinPOSTGRES_PASSWORDGenerated at deploy
joplinPOSTGRES_USERPreset in the template

Passwords and keys marked as generated are created for you when the app is deployed and stored as secrets. Values are not shown here.

Deploy Joplin Server with Levelrail ​

In the dashboard, open Apps, choose New app, then Browse templates, and select Joplin Server. Review the Compose body and deploy.

With the CLI:

levelrail-cli templates deploy joplin-server --name my-joplin-server

See Service template catalog for how templates work, and Getting started if you have not installed Levelrail yet.

More Productivity templates ​

All templates are listed in the self-host gallery.

Released under the Apache 2.0 License.