Importing an Image

Images can be imported and managed individually, outside of stacks. This guide covers how to import an image from various sources.

The image import form is nearly identical to the import form used on the single container deploy wizard. Using this form, you can (re)import images individually. To get to the main image import form, follow these steps:

  1. Click Images in the nav menu on the left hand side.
  2. In the top right corner, click the blue Import Image button.

Import Sources

Cycle does not store your credentials for your private registry or repository. You will need to provide them every time you import that image.

Using the tabs on the left, select the source you wish to import from. At this time, you can import from either Docker Hub, or a private Docker Registry.

Docker Hub

Typing in the "Image Name" box will automatically search hub.docker.com as you type, returning images along with their description and rating. Select your image from the list (or enter a custom one), then set the tag in the tag field. By default Cycle will import the 'latest' tag. You may also provide custom authorization by selecting the "Use Auth" checkbox. Enter your username and password into the respective fields.

Docker Registry

If you choose to import from a Docker Registry, the process is the same, except in the URL field you will need to enter the custom url the registry is hosted on. For example, if your image name isimages.example.com/myimage:latest, you would enter images.example.com into the URL field. It's recommended to host your own Docker Registry on Cycle for extra security instead of using the public Docker Hub option.

Import Progress

Once you have filled in all the information, click Import. You will be taken to a page where you can watch the import progress. When it is finished, you can jump directly to the image's main page by clicking Go To Image.

The portal is a live interface, so feel free to navigate away from the import page. It will continue in the background, and you will be notified when it is complete.

Need Help?

If you've got questions about the platform or need some help getting started, our team is more than happy to assist. Whether you're new to containers or just new to Cycle, reach out to us via livechat by clicking the blue circle in the bottom right corner. Join our Slack channel, and get help from the dev team or other members of the community, and check out our Roadmap to see what's planned for the future!