This page is a summary of the steps we took to get browsertrix-cloud running on-prem in a k3s installation at KB.
Mostly this page is just a summary of the contents of the slack thread https://iipc.slack.com/archives/C02DUU7US9M/p1692966466359669?thread_ts=1685144091.950199&cid=C02DUU7US9M
Firstly, IT services installed k3s on a single machine and disabled SELinux.
The first thing to do after this is set the right kubectl configuration:
The browsertrix-cloud installation is based on the nginx ingress so you must disable traefik:
Then install cert-manager and ingress-nginx
(Possible helm upgrade --install nginx ingress-nginx/ingress-nginx -n ingress-nginx --create-namespace)
Now clone or download browsertrix cloud. We installed from the ansible-k3s branch, but that should soon be merged with main. Change directory to the browsertrix-cloud directory
and edit the file ./chart/examples/local-config.yaml by adding the following:
(replacing btrix-cloud-devel-02.kb.dk with your hostname.)
Then install browsertrix-cloud
after this just wait for everything to come up and you should be ready.
Users and Registration
Initially you only have the default user as documented in system documentation.
You can invite new users in the web gui, but the confirmation emails don't get sent in the default setup. However you can read the confirmation url in the backend log via
or using the kubernetes dashboard if you have that up and running
Limitations with Self-signed Certificates
Since this installation is with self-signed certificates, there can be problems with some functionality. In particular, we could not at first get replay to work in chrome. We found various workarounds:
- Start chrome from the command line with "--ignore-certificate-errors" and replay one harvest. Quit chrome and start normally. Now it should work for a while.
- Use Firefox.
- Learn how to install a valid TLS certificate.
We also installed the kubernetes dashboard on port 8001. To access this at the moment you need to login to the machine and obtain a token: