Skip to content

About

This is a NEthserver 8 Module for Joplin Server Edition,

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

125 Commits

Folders and files

Repository files navigation

ns8-joplinserver

Joplin is an open source note-taking app. Capture your thoughts and securely access them from any device.

Module id: Joplin. Images are pinned in build-images.sh and updated through reviewed changes.

Install

add-module ghcr.io/geniusdynamics/joplinserver:latest 1

The command returns the instance id, for example Joplin1. Use the id NS8 returns.

Configure

api-cli run configure-module --agent module/Joplin1 --data - <<'EOF'
{
  "host": "joplinserver.example.org",
  "http2https": true,
  "lets_encrypt": false
}
EOF
Parameter Required Type Description
host yes string Host name for the application, like 'joplin.domain.org'
lets_encrypt yes boolean Request a valid Let's Encrypt certificate.
http2https yes boolean Redirect all the HTTP requests to HTTPS

Configuration output

get-configuration returns: host, lets_encrypt, http2https.

Images

Image Version
docker.io/postgres 16.16
docker.io/joplin/server 3.4.3

Network and access

  • Reserves 1 TCP port(s) on the node. The web application is published through Traefik on the configured host name.
  • Runs rootless.
  • Declares these NS8 authorizations: traefik@node:routeadm.

Backup

The following paths are included in the NS8 backup (imageroot/etc/state-include.conf):

  • volume/postgres-data
  • state/joplin.pg_dump
  • state/database.env
  • state/app.env
  • state/joplin-db.env

Services

  • joplin-pgsql.service
  • joplin-server.service
  • joplin.service

Get the configuration

api-cli run get-configuration --agent module/Joplin1

Update and uninstall

api-cli run update-module --data '{"module_url":"ghcr.io/geniusdynamics/joplinserver:latest","instances":["Joplin1"],"force":true}'
remove-module --no-preserve Joplin1

Testing

Continuous integration:

  • Publish images builds the module image on every push.
  • Test module installs the image on a QEMU NS8 node and runs the Robot Framework suite in tests/. It runs after Publish images succeeds on dev and on main.
  • Build API JSON Schema docs and the security scan run alongside.

The suite installs the module, configures a host name, checks that the web application answers through Traefik, takes UI screenshots and removes the module.

Run it locally with the NS8 standard infrastructure described in the ns8-github-actions README.

Upstream

Application documentation: https://joplinapp.org/help/

License

GPL-3.0-or-later. See LICENSE.

About

This is a NEthserver 8 Module for Joplin Server Edition,

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages