How to: Add Registries

Panamax supports adding secure (https) and insecure (http) registries, as well as registries with basic auth and certificate authority. Based on the type of registries and authentication method (if any) can determine how to set it up in Panamax.

Insecure and Secure Registries

When installing Panamax, along with CPU and RAM allocation, you can set whether you want to connect to insecure registries. By default, this option is set to NO, which matches the default setting for the docker daemon. With this option set to NO, docker doesn't allow access to any registry with http. To allow for legacy insecure registry access, select Y during the Panamax installer setup. To change your setting, run $ panamax and select reinstall or panamax reinstall --insecure-registry from a command prompt.

Registries with Basic Authorization and Certificates

Registry behind SSL

With Certificate Authority

No action is needed.

With Self-Signed Certificate

Add your .pem file to CoreOS.Following these steps:

1. In a terminal window: $ panamax ssh
2. Complete the setup following these instructions.
3. Restart docker daemon: $ sudo systemctl restart docker.service
4. Test your connection: $ curl https://your_registry_endpoint/v1/_ping - returns json description blob

Registry behind Basic Auth

1. Follow instructions for either Certificate Authority or Self-Signed Certificate above
2. $ panamax ssh
3. $ docker login -e your_email.com -u your_username -p your_password https://your_registry_endpoint - returns Login Succeeded
4. $ sudo cp /home/core/.dockercfg / - Important: When Panamax attempts to pull, it will look here (/) for credentials.

This gives the docker daemon your creds and registry endpoint. Within Panamax, you now can use the search command filter to directly access a secure repository. You can repeat this for as many secure registries you have.

Running an Image from a Private Repository

Panamax now supports a search command filter to allow you to enter the absolute URI to your image in a private registry or a docker private repository. For example, to use the image my_private_repo/ubuntu:14.04 use the != command in the search control to specific the absolute path to your image:

!=my_domain.com/my_private_repo/ubuntu:14.04

Panamax will confirm your selection by displaying the image endpoint. To run the image, simply click the Run Image button to add it to your Panamax application. Be sure to check the journal output for the service to ensure no errors occurred.

NOTE: If your repository is behind basic auth, or needs certificate authority, be sure to read Registries with Basic Authorization and Certificates for instructions on how to add those to your Panamax install.