Docker Registry Setup
Authenticate to the QuickCloud private Docker registry and pull your product images.
Docker Registry Setup
QuickCloud products are distributed as Docker images from a private registry at registry.quickcloud.co. This page covers authentication, credential management, and common issues.
Your credentials
When your subscription was activated, we sent a welcome email with:
- Registry URL —
registry.quickcloud.co - Username — unique to your account (format:
qc_xxxxxxxx_bundlename) - Password — a 32-character random token
If you can't find the email, you can rotate your credentials from the dashboard — this generates a new password and sends it to your inbox.
Logging in
echo "YOUR_PASSWORD" | docker login registry.quickcloud.co \
-u YOUR_USERNAME --password-stdinDocker stores the token in ~/.docker/config.json. You only need to log in once per machine.
Using credentials in CI/CD
GitHub Actions
- name: Log in to QuickCloud registry
uses: docker/login-action@v3
with:
registry: registry.quickcloud.co
username: ${{ secrets.QUICKCLOUD_REGISTRY_USERNAME }}
password: ${{ secrets.QUICKCLOUD_REGISTRY_PASSWORD }}Add QUICKCLOUD_REGISTRY_USERNAME and QUICKCLOUD_REGISTRY_PASSWORD as repository secrets in GitHub → Settings → Secrets and variables → Actions.
GitLab CI
before_script:
- echo "$QUICKCLOUD_REGISTRY_PASSWORD" | docker login registry.quickcloud.co
-u "$QUICKCLOUD_REGISTRY_USERNAME" --password-stdinKubernetes (image pull secret)
kubectl create secret docker-registry quickcloud-registry \
--docker-server=registry.quickcloud.co \
--docker-username=YOUR_USERNAME \
--docker-password=YOUR_PASSWORD \
--docker-email=your@email.comThen reference it in your pod spec:
spec:
imagePullSecrets:
- name: quickcloud-registryRotating credentials
You can rotate your registry password at any time from the dashboard under Registry Access → Rotate credentials. This immediately invalidates the old password — update any scripts or CI secrets afterward.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
unauthorized: authentication required | Wrong username or password | Check your welcome email or rotate credentials from the dashboard |
denied: requested access to the resource is denied | Subscription inactive or image not in your plan | Check your subscription status in the dashboard |
no such host: registry.quickcloud.co | DNS resolution failure | Verify your network can reach registry.quickcloud.co on port 443 |