---
title: "SourceBuild troubleshooting"
slug: "sourcebuild-troubleshoot"
updated: 2026-09-17T09:18:17Z
published: 2026-09-17T09:18:17Z
canonical: "guide.ncloud-docs.com/sourcebuild-troubleshoot"
stale: true
---

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

# SourceBuild troubleshooting

Available in Classic and VPC

You might run into the following problems when using SourceBuild. Find out causes and possible solutions.

## Error when uploading build result

Build was successful, but an error occurs when uploading the build result.

#### Cause

This error may occur when the directory for the build result was set incorrectly.

#### Solution

- Verify the directory or file path for saving build results.
- Use the **Command after build** feature to check if the `/build` directory is created properly.

## Docker Rate Limit error when using Public Registry for build environment image

The "Docker Rate Limit" error occurs when using Public Registry for build environment image.

#### Cause

When using Public Registry, the image is imported via Docker Hub. And since many users use the service, the rate limit may occur. Docker Hub limits the number of image pulls within a specific time period to prevent excessive usage (see [Docker Hub pull usage and limits](https://docs.docker.com/docker-hub/usage/pulls)). We cannot provide specific limit criteria or removal conditions as Docker sets these limits based on their policies.

#### Solution

To build without Docker Hub's rate limit, we recommend uploading the image to use to [Container Registry](https://www.ncloud.com/product/containers/containerRegistry) manually and using the image as the build environment image.

Follow these steps to solve this problem:

1. From the NAVER Cloud Platform console, click **Menu** > **All Services** > **Containers** > **Container Registry** in order.
2. See [Check and manage Container Registry information](/docs/en/container-ncr-1-3) and upload the image to use to Container Registry's registry.
3. From the NAVER Cloud Platform console, click **Menu** > **All Services** > **Developer Tools** > **SourceBuild** in order.
4. Select the project to change the settings for, and click the **[Change settings]** button.
5. When the **Set build project** page appears, select the **Container Registry's image** in the **Build environment image**.
6. Change to the image uploaded to the registry, and click the **[Apply]** button.

## Docker Rate Limit error when using Docker build

The "Docker Rate Limit" error occurs when using Docker build.

#### Cause

The base image to be used for Dockerfile's FROM clause is imported via Docker Hub. And since many users use this service, the rate limit may occur. Docker Hub limits the number of image pulls within a specific time period to prevent excessive usage (see [Docker Hub pull usage and limits](https://docs.docker.com/docker-hub/usage/pulls)).

#### Solution

To build without Docker Hub's rate limit, we recommend uploading the image to use to [Container Registry](https://www.ncloud.com/product/containers/containerRegistry) manually and using the image as the base image for Dockerfile.

Follow these steps to solve this problem:

1. From the NAVER Cloud Platform console, click **Menu** > **All Services** > **Containers** > **Container Registry** in order.
2. See [Check and manage Container Registry information](/docs/en/container-ncr-1-3) and upload the base image to use for Dockerfile to Container Registry's registry.
3. Edit the FROM clause so that Dockerfile uses the image uploaded to Container Registry as the base image, and apply the change.

              Note

              

See [Enable Public Registry](/docs/en/container-ncr-1-3#%ED%8D%BC%EB%B8%94%EB%A6%AD%EB%A0%88%EC%A7%80%EC%8A%A4%ED%8A%B8%EB%A6%AC%ED%99%9C%EC%84%B1%EB%B9%84%ED%99%9C%EC%84%B1%ED%99%94) to set that anyone can download (pull) images without a separate authentication process.

## Learning resources

We offer various materials for you to explore. To learn more about SourceBuild, check out these helpful links:

- FAQs: [frequently asked questions from SourceBuild users](https://www.ncloud.com/support/faq/prod?categoryCode2=DEVTL&categoryCode3=SV_0107&page=1)
- NAVER Cloud Platform blog: [SourceDeploy & SourceBuild - provides Github Enterprise Server integration feature](https://blog.naver.com/n_cloudplatform/223272473873?trackingCode=blog_bloghome_searchlist)
- NAVER Cloud Platform blog: [Deploy applications to Kubernetes clusters - Practice using NAVER Cloud Platform's Developer Tools](https://blog.naver.com/n_cloudplatform/223209131446?trackingCode=blog_bloghome_searchlist)
- API guides: [SourceBuild API guides](https://api.ncloud-docs.com/docs/en/devtools-sourcebuild)

              Note

              

If you're still having trouble finding what you need, click on the feedback icon and send us your thoughts and requests. We'll use your feedback to improve this guide.