What is the recommended way to upgrade anthias?

1

trying to figure out the correct way to upgrade, installation was done using the install script on a base install of debian 12 as recommended, now i want to know how to upgrade it and there doesnt appear to be a clear way to do this ?

ive tried running the install script again but keep getting this error:

TASK [anthias : Sync host pip dependencies via uv] ********************************************************************************************************************************************************************************************
[ERROR]: Task failed: Module failed: non-zero return code
Origin: /home/signage/anthias/ansible/roles/anthias/tasks/main.yml:58:3

56       as the {{ anthias_user }} user.
57
58 - name: Sync host pip dependencies via uv
     ^ column 3

fatal: [localhost]: FAILED! => {"changed": false, "cmd": ["/home/signage/.local/bin/uv", "sync", "--no-default-groups", "--group", "host", "--no-install-project"], "delta": "0:00:00.038466", "end": "2026-05-04 13:47:11.183351", "msg": "non-zero return code", "rc": 2, "start": "2026-05-04 13:47:11.144885", "stderr": "Using CPython 3.13.11\nerror: failed to remove directory `/home/signage/installer_venv/lib`: Permission denied (os error 13)", "stderr_lines": ["Using CPython 3.13.11", "error: failed to remove directory `/home/signage/installer_venv/lib`: Permission denied (os error 13)"], "stdout": "", "stdout_lines": []}

docker pull images is suggested but no details on how to do this, im very familiar with linux just not with how anthias is setup using docker/ansible/python etc

any help is appreciated

2

Try running the installer again. That should sort the issue out.

3

ive already done that, hence the error i posted above.

i just tried:

systemctl stop anthias-host-agent docker
cd /home/signage
rm -rf anthias* installer_venv/ screenly* version.md .ansible/ .anthias/ .screenly
bash <(curl -sL https://install-anthias.srly.io)

and still get the same error, yes i could just blow the install away and start fresh but i want to understand whats going wrong, i should be able to update an existing install surely ?

EDIT: found this on github which fixed the issue:

EDIT2: no it didnt fix it at all i had to:

docker rm -f $(docker ps -aq)
docker rmi -f $(docker images -q)
cd /home/signage/anthias
docker compose up -d

now i have the latest images as the interface is completely different, after running the previous script i still had docker images that were 6 weeks old, all good at least i know how it works now

EDIT3: nope its still broken, after reboot i get a black screen, the web interface works but nothing on screen except an underscore in the top left…

4

Could you try upgrading to Trixie? Things should in theory work on Bookworm, but the matrix of supported devices/debian versions is getting very big and hard to test.

5

upgraded to trixie, ran your fixed installer, still didnt work, removed all traces of anthias from the system including docker images/containers, ran the fixed installer script again which worked but now i get this constantly in the journal and i cant shutdown the system from the web interface

May 11 10:09:30 Signage (python)[7048]: anthias-host-agent.service: Unable to locate executable '/home/signage/installer_venv/bin/python': No such file or directory
May 11 10:09:30 Signage (python)[7048]: anthias-host-agent.service: Failed at step EXEC spawning /home/signage/installer_venv/bin/python: No such file or directory
May 11 10:09:30 Signage systemd[1]: anthias-host-agent.service: Main process exited, code=exited, status=203/EXEC
May 11 10:09:30 Signage systemd[1]: anthias-host-agent.service: Failed with result 'exit-code'.
6

That is strange indeed. How did you invoke the installer?

Try running it like this:

bash <(curl -sL https://install-anthias.srly.io)