Installation issues and XMR

CMS Version

4.4.4

Installation Method

Custom install

Operating System

Ubuntu 24.04.4 LTS

Issue

When installing Xibo CMS, some questions and issues came to show. Major and minor, that i cannot find answers to in the documention. This is the third. :slight_smile:

Installing and configuring XMR.

The docs states that XMR is included in the “/vendor/bin” folder and that i should create a config.json there. I see no trace of an XMR or the PHAR file that i understand should be here somewhere.

After some googling, i found some year-old threads stating that i should download it separately (and that i should not be included in the release), and precisely version 1.0. Since that post was made there are newer versions up to 1.3.

The github page that contains the XMR states that:

If you are here for anything other than software development purposes, it is unlikely you are in the right place. XMR is shipped with the Xibo CMS installation and you would usually install it from there.

The docs also mentions an example upstart conf file in vendor/xibosignage/xibo-xmr/bin/upstart, but the xibo-xmr folder does not exist.
I would like to see that example file, but i also wonder what more that folder contains.

I can continue to make tests to make this work, but if someone know more precisely what should be done with the XMR it would save me a lot of time. :slight_smile:

Thanks in advance

There are a heap of breaking changes that they have introduced since version 4.2. I am updating my guide that will include how to resolve these changes.

The xmr.phar file is not included in the install archive. You need to download that seperately and place it in /vender/bin/. You place the config.json file in that directoy too.

{
    "sockets": {
        "ws": "0.0.0.0:8080",
        "api": "0.0.0.0:8081",
        "zmq": ["tcp://*:9505"]
    },
    "debug": true
}

ws is the new websockets port. api is for the connection between the CMS and XMR and really only needs localhost connection. zmq is the legacy XMR connection for clients.

The other part that you need to do that I haven’t added to my guide yet is to create some certificates. You will need to create a certs directory under you library directory. You then create the necessary certificates.

openssl genrsa -out /var/www/library/certs/private.key 2048
openssl rsa -in /var/www/library/certs/private.key -pubout -out /var/www/library/certs/public.key
php -r 'echo base64_encode(random_bytes(32)), PHP_EOL;' >> /var/www/library/certs/encryption.key

You would just need to change the lines above to point to your library location.

In Xibo Admin I configured it like this to make it work.