Docker Registry configuration parameters
To configure the service, use the following configuration parameters in ADCM.
|
NOTE
To apply a changed parameter in ADCM, perform one of the following actions: |
| Parameter | Description | Default value |
|---|---|---|
Working directory |
The absolute path on the host where Docker Registry stores container images and installation artifacts. This directory is required for both the initial deployment and subsequent cluster operations. Do not delete the unpacked bundle installation files from this directory; otherwise, system package managers ( |
/opt/arenadata/etools/registry |
| Parameter | Description | Default value |
|---|---|---|
Host |
The IP address through which the Docker Registry repository is accessible to the hosts where Arenadata products are being deployed |
— |
HTTPS port |
The port through which the Docker Registry repository is accessible |
443 |
Server certificate |
The TLS/HTTPS certificate for the Docker Registry repository in PEM (Privacy-Enhanced Mail) format. By default, this field contains the self-signed certificate generated during the installation of Arenadata products |
— |
Server private key |
The cryptographic private key matching the server certificate. It is used to secure TLS/HTTPS connections to the Docker Registry repository. RSA algorithm is recommended. Note that ADCM does not automatically validate whether the private key matches the provided server certificate. Ensure that the key pair is correct before saving the configuration |
— |
TLS Min Version |
The minimum allowed version of the TLS protocol. Possible values:
|
tls1.2 |
| Parameter | Description | Default value |
|---|---|---|
Auth Type |
Authentication method used to control access to the Docker Registry repository. If Enable Auth is enabled, this field is mandatory. Possible values: Use Use For details, see Docker Registry authentication documentation |
— |
List of users |
List of users allowed to access the Docker Registry repository when |
— |
htpasswd Authentication realm |
Authentication realm displayed to Docker clients when |
Registry Realm |
htpasswd file path (managed by ET) |
Read-only path to the ADET-managed .htpasswd file, which is used by Docker Registry for |
/opt/arenadata/etools/registry/config/.htpasswd |
Token auth realm URL |
URL of the external endpoint used for token-based authentication. When a Docker client requests access to the registry, Docker Registry redirects the client to this URL to obtain an access token. Example: |
— |
Token issuer |
Issuer of tokens used for token-based authentication. Docker Registry checks this value to verify that an access token was issued by a trusted token service. The value is case-sensitive and must exactly match the issuer value included in tokens by the token service. For example, if Keycloak is used and the realm configured for Docker Registry authentication is |
— |
Token service name |
Service name for which tokens must be issued. Docker Registry uses this value to verify that an access token is intended for this registry service. The value must match the service name used by the token service. For example, when Keycloak is used, this value can match the client ID configured for Docker Registry authentication. Only one service name is supported. The value must not contain spaces and special characters such as |
— |
CA bundle for token validation |
CA bundle used by Docker Registry to validate tokens received from the external token service. The value must contain one certificate or a certificate bundle in PEM format. If you specify multiple certificates, place them one after another in the same value, with each certificate starting with |
— |
| Parameter | Description | Default value |
|---|---|---|
Enable image deletion |
Allows deleting images from the Docker Registry repository. When enabled, clients can delete image manifests and tags through the Docker Registry API. Deleted data may not be removed from disk immediately |
false |
Storage directory |
Directory where Docker Registry stores its internal data |
/var/lib/registry |
Registry listen address |
Address and port on which Docker Registry listens for incoming connections. This address can differ from the external HTTPS port used by clients to access the registry. The default value |
0.0.0.0:8443 |
Log verbosity |
Logging level used by Docker Registry. Possible values ordered from most detailed to least detailed: |
info |
Log formatter |
Format used for Docker Registry logs. Possible values: |
text |
Container restart policy |
Restart policy applied to the Docker Registry container. Possible values: The default value |
always |
Custom Configuration Overrides |
Custom configuration parameters that override the default Docker Registry configuration. Custom configuration parameters have priority over individual configuration fields. Use this parameter for advanced settings that are not available as individual configuration fields. Nested keys are specified via dot notation, for example, |
— |