# -*- ispell-local-dictionary: "english" -*-
#+PROPERTY: TASK_CATEG opensem

* Build source code

Using ~opensem~ source code, with the ~./build.sh~, we can build a proper
~opensem-X.Y.Z.tar.xz~ that is ready for deployment.

* Charm usage

Please note that =paylib-system= relation is required and no
auto-summon exists. It won't auto-pair neither as no charm currently
provides this relation.

So you need to explicitly express this relation to a =stub= service.

* Usage

** Opensem

Typical installation of opensem would be:

#+begin_src yaml
opensem:
  charm: opensem
  options:
    env:
      mail:
        from:
          name: "Boutique Jardin En Vie"
          address: boutique@jardinenvie.com

  relations:
    publish-dir:
      frontend:
        domain: boutique.jardinenvie.com
    paybox-system:
      paybox:
        test: true
        rank: "001"  ## keep the double-quotes !
        site: 2XXXX9
        id: 2XXXXX4
        hmac-key: "FFAXXXXX...XXXXX"

paybox:
  charm: stub

letsencrypt:
  options:
    email: my-email@example.com

frontend:
  charm: mailcow-www

logrotate:

cron:

jev-smtp:
  charm: smtp-stub
  options:
    host: mail.jardinenvie.com
    port: 465
    connection-security: ssl
    auth-method: password
    login: boutique@jardinenvie.com
    password: CXXXXXXXXXXg

rsync-backup:
  options:
    ident: ext-00.jardinenvie.com
    target: my-backup-host.com
    private-key: |
      # ...
#+end_src