Docker Images
When you add an application, you can choose to use a Git repository or a Docker image built for Linux/amd64 architecture. Docker images are standalone, executable packages that contain everything you need to run your application, including the code, runtime, libraries, dependencies, and configuration files. They are built from a Dockerfile, which contains instructions for assembling the image layer by layer.
Docker images are stored in repositories called registries, such as Docker Hub, where they can be versioned, tagged, and distributed. They can be easily shared and deployed across different environments, making Docker images a portable and scalable solution for packaging and distributing software applications.
With Kinsta, you can choose to use a public Docker image from any provider without authentication; however, it’s important that you evaluate code quality and security and adhere to licensing and compliance requirements. You can also use a private image from any (or all) of the following registries:
- GitHub (ghcr.io)
- GitLab (registry.gitlab.com)
- Docker Hub (docker.io)
Private images require authentication through your registry credentials. You can add your registry credential within username > Company settings > Registry credentials.
![Registry credentials within Company settings.](https://kinsta.com/_next/image/?url=https%3A%2F%2Fkinsta.com%2Fwp-content%2Fuploads%2F2024%2F04%2Fcompany-registry-credentials-1-1024x307.png&w=2048&q=75)
To add a new set of credentials, click Create credential.
![Add your registry credentials for the Docker image registry.](https://kinsta.com/_next/image/?url=https%3A%2F%2Fkinsta.com%2Fwp-content%2Fuploads%2F2024%2F04%2Fcompany-registry-credentials-create-1024x617.png&w=2048&q=75)
Complete the fields as follows:
- Name: Enter a name for the registry credentials to identify them when adding your application.
- Registry: Choose from one of the following:
- DockerHub
- GitHub Container Registry
- GitLab Container Registry
- Username: Enter your username for the registry provider.
- Personal access token: You must obtain this from the registry provider. For more information about how to obtain a personal access token, refer to one of the following:
Click Create. Once you’ve added the required registry credentials, you can select the credentials you want to use when you add an application or within Applications > app name > Settings > General > Edit details.