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

# Docker Hub

> Connect Docker Hub with Qovery

## Overview

Docker Hub is the world's largest container image registry, hosting millions of container images. You can connect Docker Hub to Qovery to deploy both public and private images.

## Registry URL

```
https://index.docker.io/v1/
```

## Authentication

Docker Hub supports two authentication methods:

* **Access Token** (recommended for security)
* **Password** (not recommended)

<Warning>
  Use Docker Hub access tokens instead of passwords for better security and easier management.
</Warning>

## Configuration in Qovery

<Steps>
  <Step title="Create Access Token">
    1. Log into [Docker Hub](https://hub.docker.com)
    2. Go to **Account Settings** → **Security**
    3. Click **New Access Token**
    4. Give it a description and set permissions
    5. Click **Generate** and copy the token

    <Note>
      Docker Hub shows the token only once. Save it securely.
    </Note>
  </Step>

  <Step title="Access Organization Settings">
    Navigate to **Organization Settings** → **Container Registries** in Qovery
  </Step>

  <Step title="Add Registry">
    Click **Add Registry**
  </Step>

  <Step title="Select Docker Hub">
    Choose **Docker Hub** from the registry type dropdown
  </Step>

  <Step title="Enter Credentials">
    Provide:

    * **Username**: Your Docker Hub username
    * **Password**: Access token (not your Docker Hub password)
  </Step>

  <Step title="Save">
    Qovery will verify the credentials and save the configuration
  </Step>
</Steps>

## Rate Limits

Docker Hub has rate limits for image pulls:

* **Anonymous users**: 100 pulls per 6 hours
* **Authenticated users**: 200 pulls per 6 hours
* **Paid accounts**: Higher limits based on plan

<Info>
  Authenticating with Docker Hub increases your rate limit and is recommended even for public images.
</Info>

## Image Format

**Public images**:

```
<username>/<image-name>:<tag>
```

**Official images**:

```
<image-name>:<tag>
```

Examples:

* `nginx:latest`
* `mycompany/myapp:v1.0.0`

## Related Resources

<CardGroup cols={2}>
  <Card title="Container Registry Management" icon="box" href="/configuration/organization/container-registry">
    Manage all container registries
  </Card>

  <Card title="Deploy Application" icon="rocket" href="/configuration/application">
    Deploy applications from container images
  </Card>

  <Card title="GitHub Container Registry" icon="https://mintcdn.com/qovery/Nvnl0g5BHzA0XQmy/images/logos/github-icon.svg?fit=max&auto=format&n=Nvnl0g5BHzA0XQmy&q=85&s=8bd221fee047ba947afcfd39bd14ef08" href="/configuration/integrations/container-registries/github-cr" width="24" height="24" data-path="images/logos/github-icon.svg">
    Alternative container registry option
  </Card>

  <Card title="Generic Registry" icon="server" href="/configuration/integrations/container-registries/generic">
    Connect any Docker-compatible registry
  </Card>
</CardGroup>