Update Psono Admin Client

Update guide of the Psono Admin Client

Rolling-release security support

Psono is maintained as a rolling-release product. All current bug fixes and security corrections are delivered through the latest generally available release. Earlier releases and release branches are not maintained separately and do not receive backported fixes. You should therefore keep your Psono installation current by following the published update procedure. Historical releases may remain available for rollback or archival purposes, but are unsupported and may contain known or subsequently discovered vulnerabilities.

Update with Docker

1. Update the docker image

   docker pull psono/psono-admin-client:latest
   

2. Stop old psono-admin-client

   docker stop psono-admin-client
   

3. Start new psono-admin-client

   docker run --name psono-admin-client-new \
       -v /opt/docker/psono-client/config.json:/usr/share/nginx/html/portal/config.json \
       -d --restart=unless-stopped -p 10102:80 psono/psono-admin-client:latest
   

4. Cleanup

   If everything works you can cleanup your containers with the following commands:

   docker rm psono-admin-client
   docker rename psono-admin-client-new psono-admin-client
   

If anything fails you should be able to start the old docker container again.

Update without Docker

The admin client is a pure html / js website, that can be hosted with any webserver and has zero dependencies.

1. Download the webclient artifact

   Visit the following url and download the webclient:

   get.psono.com/psono/psono-admin-client/latest/adminclient.zip (opens new window)

2. Backup htdocs/portal folder

   Before you replace any files you should backup your htdocs/portal folder

3. Install webclient

   Unpack the webclient into the htdocs/portal folder of your webserver.

4. Restore config.json

   Copy the old config.json and replace the one in the htdocs/portal folder

5. Adjust permissions

   chmod -R 644 htdocs/portal
   

If anything fails you should be able to restore your admin portal restoring the files from the backuped folder.