ns8-joplin

This is an NS8 module for Joplin.

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

Install

Instantiate the module with:

add-module ghcr.io/compgeniuses/joplin:latest 1

The output of the command will return the instance name. Output example:

{"module_id": "joplin1", "image_name": "joplin", "image_url": "ghcr.io/compgeniuses/joplin:latest"}

Configure

Let's assume that the mattermost instance is named joplin1.

Launch configure-module, by setting the following parameters:

• host: a fully qualified domain name for the application
• http2https: enable or disable HTTP to HTTPS redirection (true/false)
• lets_encrypt: enable or disable Let's Encrypt certificate (true/false)

Example:

api-cli run module/joplin1/configure-module --data '{"host": "joplin.domain.com","lets_encrypt": false,"http2https": true}'

Multiple

api-cli run configure-module --agent module/joplin1 --data - <<EOF
{
  "host": "joplin.domain.com",
  "http2https": true,
  "lets_encrypt": false
}
EOF

Default Login Credetnilas

Kindly Change these credentila sthe moment you login to joplin.

Default Login Credetnials are:

• Email: admin@localhost
• Password: admin

The above command will:

• start and configure the joplin instance
• configure a virtual host for trafik to access the instance

EMail configs

MAILER_ENABLED=1
MAILER_HOST=smtp.gmail.com 12
MAILER_PORT=587
MAILER_SECURITY=starttls
MAILER_AUTH_USER=my_email_address
MAILER_AUTH_PASSWORD=my_password
MAILER_NOREPLY_NAME=JoplinServer
MAILER_NOREPLY_EMAIL=my_email_address

Get the configuration

You can retrieve the configuration with

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

update

To update the instance:

api-cli run update-module --data '{"module_url":"ghcr.io/compgeniuses/joplin:latest","instances":["joplin1"],"force":true}'

Uninstall

To uninstall the instance:

remove-module --no-preserve joplin1

Smarthost setting discovery

Some configuration settings, like the smarthost setup, are not part of the configure-module action input: they are discovered by looking at some Redis keys. To ensure the module is always up-to-date with the centralized smarthost setup every time joplin starts, the command bin/discover-smarthost runs and refreshes the state/smarthost.env file with fresh values from Redis.

Furthermore if smarthost setup is changed when joplin is already running, the event handler events/smarthost-changed/10reload_services restarts the main module service.

See also the systemd/user/joplin.service file.

This setting discovery is just an example to understand how the module is expected to work: it can be rewritten or discarded completely.

Debug

some CLI are needed to debug

• The module runs under an agent that initiate a lot of environment variables (in /home/joplin1/.config/state), it could be nice to verify them on the root terminal

  runagent -m joplin1 env

• you can become runagent for testing scripts and initiate all environment variables

  runagent -m joplin1

the path become :

    echo $PATH
    /home/joplin1/.config/bin:/usr/local/agent/pyenv/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/usr/

• if you want to debug a container or see environment inside runagent -m joplin1

podman ps
CONTAINER ID  IMAGE                                      COMMAND               CREATED        STATUS        PORTS                    NAMES
d292c6ff28e9  localhost/podman-pause:4.6.1-1702418000                          9 minutes ago  Up 9 minutes  127.0.0.1:20015->80/tcp  80b8de25945f-infra
d8df02bf6f4a  docker.io/library/mariadb:10.11.5          --character-set-s...  9 minutes ago  Up 9 minutes  127.0.0.1:20015->80/tcp  mariadb-app
9e58e5bd676f  docker.io/library/nginx:stable-alpine3.17  nginx -g daemon o...  9 minutes ago  Up 9 minutes  127.0.0.1:20015->80/tcp  joplin-app

you can see what environment variable is inside the container

podman exec  joplin-app env
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
TERM=xterm
PKG_RELEASE=1
MARIADB_DB_HOST=127.0.0.1
MARIADB_DB_NAME=joplin
MARIADB_IMAGE=docker.io/mariadb:10.11.5
MARIADB_DB_TYPE=mysql
container=podman
NGINX_VERSION=1.24.0
NJS_VERSION=0.7.12
MARIADB_DB_USER=joplin
MARIADB_DB_PASSWORD=joplin
MARIADB_DB_PORT=3306
HOME=/root

you can run a shell inside the container

podman exec -ti   joplin-app sh
/ # 

Testing

Test the module using the test-module.sh script:

./test-module.sh <NODE_ADDR> ghcr.io/compgeniuses/joplin:latest

The tests are made using Robot Framework

UI translation

Translated with Weblate.

To setup the translation process:

• add GitHub Weblate app to your repository
• add your repository to [hosted.weblate.org]((https://hosted.weblate.org) or ask a NethServer developer to add it to ns8 Weblate project