Repository Server using Docker Image

Oh, now I understand where your confusion is coming from. You are only using the WebUI (or HTML UI) component of the server, not the Repository Server (GRPC server) component. I’ll try to explain:

  • The WebUI is basically an alternative to KopiaUI (the desktop app) for systems which do not have a GUI. In case of the docker-compose file you are connecting the WebUI directly to the repository as the repository owner. But you can aswell start the WebUI on a client to connect to a remote Repository (GRPC) Server.
  • The Repository (GRPC) Server adds user management and access control. And it abstracts the underlying storage layer, so you can swap the storage on the server side without changing anything on the client side.
    To use the Repository Server you need to add users with kopia server user add.
  • Both components can be disabled by using the --no-ui or --no-grpc option.

Some more notes:

KOPIA_PASSWORD basically is the master password for the owner (or creator) of the repository.

The docker-compose example in the documentation uses a --server-username=USERNAME and --server-password=SECRET_PASSWORD parameter to start the server. Those values are used for HTTP authentication (basic auth) in the WebUI. No htpassword file needed.

The “server password” you are asked for when connecting to a Repository Server in the WebUI or desktop app is the password you provided when creating the user with kopia server user add.
Also make sure to unhide the advanced options on this page and check username and hostname. Those values are case-sensitive and need to exactly match the username you used with kopia server user add.

The server-control-password is required to run API commands (e.g. kopia server refresh). Ignore that for now.

Always happy to help - as a non-programmer that’s my way of contributing and saying thank you to the developers.
And I do understand the rant because some parts of the documentation were clearly written from a developer perspective who knows everything about it.

2 Likes