Set custom headers to the registry example
The interface and the docker registry will be accessible with http://localhost.
This example highlight the usage of custom headers when the UI is used as a proxy. When you wants to use a header name with hyphens, replace them by underscores in the variable. You can put headers in environment variable or in config file
/etc/nginx/.env. They have the same writing style.
Headers can be useful in some cases such as avoid sending credentials when you are on the UI. Or give to the registry server other properties such as X-Forward-For header.
I will set these two headers in this example. X-Forward-For by environment variable and Authorization by file.
In order to set your credentials in the header, you need to know how Authorization header works. Here we use the
Basic authentication scheme, the credentials are constructed like this:
- The username and the password are combined with a colon (
- The resulting string is base64 encoded (
cmVnaXN0cnk6dWk=). You can simply run
echo -n "registry:ui" | base64.
- In your header, put this value
- In your
/etc/nginx/.env, the file will contains
For X-Forward-For, replace all hyphens by underscores, and the value will be a nginx variable which is
$proxy_add_x_forwarded_for. In your docker compose you will need to duplicate the
$ character. In your docker-compose, your environment will look like
As usual, run the project with
docker-compose up -d (for background mode)