> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sevalla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Docker images

> Manage your Docker images and learn how to use them for deployments.

When you add an application, you can choose to use a [Git repository](/applications/git/overview) 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 Sevalla, 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)

<Info>
  Sevalla only supports Docker images built for Linux/amd64 architecture. This is validated when you add an application and during the rollout phase.
</Info>

Private images require authentication through your registry credentials. You can add your registry credentials within **Integration** > **Registry credentials** > **Create registry credential**.

<Frame caption="Registry credentials within Settings.">
  <img className="block dark:hidden" alt="Registry credentials within Settings" src="https://mintcdn.com/sevalla/xgVrVYuhS59aOzzl/images/new-registry-credential-light.png?fit=max&auto=format&n=xgVrVYuhS59aOzzl&q=85&s=dc3fcacd968227c3fda4a7da3d824c34" width="3680" height="1134" data-path="images/new-registry-credential-light.png" />

  <img className="hidden dark:block" alt="Registry credentials within Settings" src="https://mintcdn.com/sevalla/xgVrVYuhS59aOzzl/images/new-registry-credential-dark.png?fit=max&auto=format&n=xgVrVYuhS59aOzzl&q=85&s=f94564912858117f1d33dcfb1fe11ca6" width="3680" height="1134" data-path="images/new-registry-credential-dark.png" />
</Frame>

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:
  * [DockerHub](https://docs.docker.com/security/access-tokens/)
  * [GitHub](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)
  * [GitLab](https://docs.gitlab.com/user/profile/personal_access_tokens/)

Click **Create registry credential**.

<Frame caption="Add your registry credentials for the Docker image registry.">
  <img className="block dark:hidden" alt="Add your registry credentials for the Docker image registry" src="https://mintcdn.com/sevalla/bgLCf4Xd83tbb_SG/images/registry-credential-create-light.png?fit=max&auto=format&n=bgLCf4Xd83tbb_SG&q=85&s=285bbd61a2faf0d2b5804b92e37a2128" width="1182" height="980" data-path="images/registry-credential-create-light.png" />

  <img className="hidden dark:block" alt="Add your registry credentials for the Docker image registry" src="https://mintcdn.com/sevalla/bgLCf4Xd83tbb_SG/images/registry-credential-create-dark.png?fit=max&auto=format&n=bgLCf4Xd83tbb_SG&q=85&s=bd5b937bd4f1d5eae537098390f998af" width="1190" height="968" data-path="images/registry-credential-create-dark.png" />
</Frame>

Once you've added the required registry credentials, you can select the credentials you want to use within **Applications** > ***app name*** > **Settings** > **Build strategy** > **Update build strategy**.
