Using CircleCI
Here you'll find comprehensive solutions and debugging strategies to troubleshoot any issues while using CircleCI. These articles provide resources to easily and quickly resolve any issues on our platform.
413 articles
- Scheduled Pipeline Troubleshooting Checklist
- Scheduled Pipeline Not Running When Using the Scheduled Actor
- Scheduled Pipeline Stopped Running After a Team Member Left
- How to Clear the Date Filter on the Pipelines Dashboard
- When to use checkout: method: full (after blobless default)
- Git LFS Files Not Pulled During Checkout on Docker and Machine Executor Images
- "fork: retry: Resource temporarily unavailable" When Using Command Substitution in $BASH_ENV
- How to Fix Pipelines Page Performance
- Reducing iOS Simulator CPU Overhead on macOS Executors
- Troubleshoot "The authenticity of host 'github.com' can't be established" message during job execution.
- Config file could not be found when using continuation orb
- Setup Workflows re-run from UI fails with error: {"message":"Continuation key has expired. Please run a new pipeline."}
- How to ignore a failure in a step
- Integers Longer Than 6 Digits Will Be Converted in Job Level Environment Variables
- Can I split a config into multiple files?
- Seeing a build failure every day which I didn't set up
- How to Prevent Triggering Builds on Commit Pushes
- Blobless Checkout, and How to Opt In and Out
- CircleCI Audit Log Events Reference
- Why serial-start Fails: Serial Group Priority
- How to Trigger a Workflow Based on Environment Parameters in CircleCI
- Resolving Cache Upload Errors and Stuck Cache Issues in CircleCI
- Troubleshooting "Job failed due to excessive parallelism"
- Enabling Docker Experimental Features on Remote Docker
- How To Set Up a VPN Connection During Builds
- Accessing $BASH_ENV Results in "No such file or directory"
- Why is CIRCLE_PR_NUMBER empty?
- Directory with space in name not working for 'working_directory'
- Troubleshooting passing pipeline values within an orb to a job
- How to solve the escaping character error
- Using GitHub App Functionality in a GitHub OAuth App Organization
- How to edit config.yml
- How do I configure a pipeline in the UI?
- Resolving Missing OIDC Token Issues in CircleCI
- Can I create pipeline for an external GitHub repo?
- Is There a Limit on the Number of Contexts I Can Have in a Config?
- [Limited Availability]Introducing the AI Assisted Pipeline Editor
- Order Workflows in CircleCI
- How to Delete a Pipeline in CircleCI
- How to give a workflow a nickname
- How to run a workflow when the previous one failed
- Conditional steps in jobs and conditional workflows
- Time-Limit for Approval/Hold Job
- Using Multiple Line(newline) Environment Variables in CircleCI
- Does CircleCI support matrix config?
- Maximum Size of a CircleCI Configuration File (config.yml)
- How to Retry a Failed Step with "when" Attribute?
- Troubleshooting OpenVPN timeouts in CircleCI workflows
- Adding Timestamps to Commands in CircleCI
- Update to Dynamic 'when' Statements in Workflows
- Resolving HEREDOC Errors in CircleCI YAML Configuration
- How to View the IP Address Used by Your Machine
- How can I conditionally run a job if another job passes or fails?
- Which CircleCI Resources are made Available to Users on the Free Plan?
- Troubleshooting "2 schema violations found required key [jobs] not found required key [version] not found"
- Source a bash file before every command
- Can I cache my dependencies on CircleCI?
- Understanding the "fatal: reference is not a tree" Error in Git
- python3 Does Not Recognize Packages Installed With pip
- Regex for Branch Filtering in CircleCI
- Understanding Jobs and Tasks in CircleCI
- Can I use environment variables in conditional statements?
- How to use a Specific SSH Key for Git Clone
- How to use pre and post steps with orb job commands
- Managing GitHub Authentication in Composer-Based Projects
- How to validate your CircleCI configuration
- How to insert files as environment variables
- Filter workflows by branch
- How do I set the timezones in Docker images?
- Pinning a Docker Image to a Specific Version
- How do I modify the checkout step?
- Understanding Exit Status Code 255
- Why is there an `analyze-my-code` workflow in my project?
- Can I change the value of circleci_ip_ranges based on the branch?
- CircleCI Associate Developer Certificate
- How to Run the Same Job Twice in a Single Workflow
- How to Add Deprecated Debian Stretch Repositories
- How to use branch filters with IP ranges
- Troubleshooting CIRCLE_CONTINUATION_KEY is required. Make sure setup workflows are enabled.
- Troubleshooting "Command Not Found" in Multi-Container Docker Jobs
- Example CircleCI Projects & Language Guides
- Troubleshooting issues with special characters in environment variables
- How do I run Powershell as Another User?
- Troubleshooting checkout step failing - Alpine image
- Adjust Ports on Windows Firewall for your Applications
- Setting and Using Environment Variables in the windows environment
- How to execute a step in the background on CircleCI
- How to set resources limits CPU and RAM (memory) for container runner
- How to pass environment variables between jobs
- Docker Executor returning Total Host CPU Cores
- How to set resource class configuration for container runner
- How to install iLok License Support Installer silently
- Use specific executor based on branch with dynamic configuration
- Troubleshooting self hosted runner: ERRO[2400] error running task error on RedHat
- How To Locate Your Repo Files When Using CircleCI
- Troubleshooting: Config Processing Error - "Don't rerun this job"
- Troubleshooting Error: "This job has been blocked because resource-class:2xlarge is not available on your plan. Please upgrade to continue building."
- Set a dated file name using environment variables
- How to authenticate multiple AWS profiles using OIDC
- Conditionally setting values in the config file
- We were unable to run this job. Please check your configuration and try again.
- Adjust screen resolution on Windows executor
- Troubleshooting Error Message: "Max number of workflows exceeded."
- "Cannot add more than 100 environment variables to a context"
- How to push a commit back to the same repository as part of the CircleCI job
- Resolving: "CircleCI was unable to start the container"
- Port conflicts with service containers on Docker executor
- Storing Secret Files (certs, etc.)
- Available Docker versions
- How to Set Up iOS and macOS Code Signing on CircleCISet up iOS and macOS code signing on CircleCI by uploading Apple certificates and provisioning profiles via the API. Covers .p12 certificates, signing bundles, Developer ID, Apple Distribution, Mac Developer…
- Unexpected Python version in cimg/python convenience images
- Scheduled Workflow Stopped Running With No Config Changes
- CircleCI Feature Releases: Preview, Beta, and General Availability
- What do the status icons mean in CircleCI pipelines?
- Jobs Queuing or Stuck in "Not Running" / "Preparing" State
- Troubleshoot "The authenticity of host 'github.com' can't be established" message during job execution.
- Can I delete a project?
- Error received: This job was claimed but has not received a heartbeat in over 5 minutes
- Troubleshooting "Unable to locate package" when running `apt install`
- Automatically cancel build after set amount of time
- Context deadline exceeded after 1 hour - Build timed out (Free tier only)
- Cannot Rerun an Old Workflow or “On Hold” Job
- Auto-cancel workflow via run step
- Build Isolation and Container Lifecycles
- CircleCI Runner Error Message: "We cannot run this job using the selected resource class."
- How do I limit specific users from starting builds?
- Edit file in CircleCI Windows job
- Build “Not Running” Due to Concurrency Limit but No Other Job Is Running
- Add Timing Data to Each Output Line
- Navigating to the failed job page displays a "Page Not Found"
- Blobless Checkout, and How to Opt In and Out
- npm is seeing error code E401 / 401 unauthorized from NPM registry
- CircleCI Infrastructure Failures: Detection and Handling
- Feature Parity Between Cloud and Server
- Troubleshooting unauthorized build due to permission to contexts
- Can I rename my organization?
- Resolving Unexpected CIRCLE_PULL_REQUEST Environment Variable in CircleCI main branch Builds
- Conditionally Stop Job When Only Change Was to config.yml File
- How do I install and use Linuxbrew?
- Debugging Docker Build Step Timings
- Build Fails Using 'apt-get update' Command
- Swap Node Version on CircleCI Convenience Image
- Exit Build Early if Any Test Fails
- Docker: Error Response From Daemon - unauthorized: incorrect username or password
- Docker Build Fails With “Exited With Code Exit Status 56” When Downloading Assets
- How To Rerun a Workflow
- How to Check Available Space on Remote Docker and Docker Layer Caching
- Troubleshooting [ci skip] or [skip ci] Not Working
- JAXB Missing on CircleCI Android Docker Images
- Java Builds Fail With `Unrecognized VM option 'UseCGroupMemoryLimitForHeap'`
- Getting help for an issue with a CircleCI convenience image
- Using rbenv on macOS Xcode Images
- Resolving "fatal: reference is not a tree" Error and Inconsistent Test Failures in CircleCI
- Unable to Set Up New Projects in New GitHub Organizations
- Standalone Organization Integrations Do Not Auto Import All Projects
- What is an "ECONNRESET" Error?
- Can I Use WSL2 on the Windows Executor?
- How to Edit Files or Restart Docker Daemon in Remote Docker Environment
- Troubleshooting "Failed to fetch package.deb 404 Not Found"
- Using git-lfs on CircleCI Docker images
- ERROR: Failed to download Chromium r686378!
- Delete Build Logs From Removed Projects
- How To Record a Job’s Memory Usage
- Troubleshoot "warning: Clone succeeded, but checkout failed." Error
- Utilizing git rev-list with revision range
- Troubleshooting "Either git or ssh is Not Installed in the Image"
- Either git or ssh (required by git to clone through SSH) is not installed in the image.
- Build Fails with "Too long with no output (exceeded 10m0s): context deadline exceeded"
- How do I delete trigger and pipelines
- Understanding Different Status Badges in CircleCI Builds
- Troubleshooting: Project Creation Limits on CircleCI's Free Plan
- Using xvfb to run applications
- Why Are Words Being Masked with Asterisks in the Build Log?
- Can I delete a specific build?
- Apt-Get Update Is Slow Or Locked
- How to pass Docker images between Jobs
- Troubleshooting Job Completes After "Spin up Environment" for Arm-Based Docker Images
- Conditionally End a Running Job Gracefully
- How to run docker commands when SSH-ing into a rebuild that uses a remote Docker engine
- Can’t Read From Remote Git Repository During npm install
- There was an issue while running this container and it was rerun. The most recent run is shown.
- Sending Emails from CircleCI Containers
- How to uninstall CircleCI from GitHub App
- Why can't I view the build history on my project?
- Can I delete a Project that was integrated with CircleCI?
- How can I use Docker volume mounting on CircleCI?
- Build has Hit Timeout Limit
- Why isn't my glob pattern recursing all folders?
- Race Conditions - Wait For Database
- Troubleshooting: attach_workspace Step Fails to Extract Workspace
- error while loading shared libraries: libgconf-2.so.4: cannot open shared object file: No such file or directory
- Permission Denied When Creating Directory or Writing a File
- No matching manifest for linux/amd64 in the manifest list entries
- How do I create a custom docker image for CircleCI?
- Open ports to access builds externally
- How to Schedule a Nightly Build
- Docker Daemon Not Available
- Dockerfiles for pre-built convenience images
- Step Should Fail but Job Finished Successfully
- Why can't I find one of the branches on the branch filter drop-down?
- Why do some projects default to different resource classes?
- Why aren't my branches showing up in CircleCI?
- How Can I See the Date and Time a Build Started or Ended
- The container name "X" is already in use by container...
- Requesting New or Updated CircleCI Convenience Images
- Kubernetes Troubleshooting
- Troubleshooting Workflows with an Undefined End Time
- An error occurred while fetching your repositories. Please refresh to try again.
- How to install NPM on Windows images
- How To Set Up jEnv on CircleCI With $BASH_ENV
- Cancel All Jobs
- How to resolve `The following signatures couldn't be verified because the public key is not available` when building a docker image
- Checkout Step Intermittently Failing
- Handling Transient Failures with Retry Logic
- Executor support for CircleCI IP ranges
- Runner Timeout Limit Hit: context deadline exceeded
- Troubleshooting: Build Fails Due to SSH Handshake
- Uninstalling pre-installed software on convenience images
- Support for Scheduled Workflows in Dynamic Configurations / Setup Workflows
- Troubleshooting Remote Docker via Syslog and Dmesg
- Auto-Cancel Re-Run if Newer Commit Exists
- Check Available Disk Space with Remote Docker and Docker Layer Caching
- How To View All Jobs for a Project
- Troubleshoot "Expired GPG key" Error in Build
- Default shell in Docker convenience images
- Why are my jobs queueing?
- How do I run commands in the remote Docker environment and understanding how this mirrors Docker in Docker?
- Troubleshooting why won't my daemon or service stay up?
- Can External/Non-Authenticated Users Access my Artifacts with the URL?
- Troubleshooting: Artifact Downloads Result in Errors on Safari v14.XX
- Store chocolatey logs for further troubleshooting
- Access uploaded artifact URL in job
- Chrome Downloading Single File Artifacts as a Zip File
- Store artifacts destination does not match the path
- Artifacts Missing
- Uploading artifacts is slow
- Uses for artifacts (and limitations)
- How to Programmatically Construct the URLs for Artifacts
- appx and nupkg Artifact Files Download is Automatically Renamed to Zip
- CircleCI Feature Releases: Preview, Beta, and General Availability
- When I Push 4 or More Tags in a Single Push, No CircleCI Workflows Are Triggered
- How to Trigger Pipelines Selectively Using an Approval Job
- How to manually run a pipeline
- Schedules Not Running On OAuth Organisations
- Config not found on Scheduled Pipelines
- Retrieve Logs on a Machine Runner
- How to add a step that triggers pipeline in different project
- Are custom webhooks supported when using the CircleCI GitHub OAuth integration?
- Where is the Only Build PR Option in GHA Integrations?
- Why do I see "No workflow" when I push a commit or a tag
- Why are pull requests not triggering jobs in my organization?
- Triggering CircleCI Builds Across Branches with Conditional Fallbacks
- Why can't I add a trigger or schedule?
- Troubleshooting duplicate builds triggered upon every commit/push
- "You don't have permission to approve this job"
- My Project Has Been Suspended
- How to Manually Trigger a Scheduled Pipeline
- Troubleshooting CircleCI runner issue /api/v3/runner/claim was 401 (Unauthorized)
- Troubleshooting "Error Fetching Config" Error on GitLab Pipelines
- Troubleshooting Gitlab POST api: "message": "An internal server error occurred."
- Check trigger source for API
- Workflow appears stuck running after jobs have finished or been canceled
- Migrating from pipeline.trigger_source to pipeline.trigger.typepipeline.trigger_source is being deprecated, and users should now switch to pipeline.trigger.type
- Troubleshoot "The authenticity of host 'github.com' can't be established" message during job execution.
- GitHub SSH Deprecation Information & Resolutions
- Using Vim in SSH session on Windows executor
- Preserve Environment Variables While Debugging With SSH
- Change SSH Key Format For Use With Tools Requiring RSA
- How to troubleshoot to SSH into instances
- How to run or skip a step when a job is rerun with SSH
- How to see running SSH jobs
- Who has access to SSH into a job?
- Why Can't I See The ReRun Via SSH Option?
- Troubleshooting "Bad credentials" errors when using git clone with Git LFS
- Disable re-run job with SSH
- Problems connecting to SSH session using Warp terminal for macOS
- Can I adjust the default timeout of jobs in an active SSH session?
- Understanding how CircleCI executes your shell commands
- Context error preventing job re-run with SSH
- Permission error when trying to SSH into a job
- SSH Rerun Job Step Not Showing Up
- Debugging with SSH: How to Rerun a Job with SSH
- Incorrect Test Count in the Tests Tab When Using JUnit XML
- Are My Builds Being Throttled?
- Is CircleCI having issues or is it something on my end?
- Debug Ruby RSpec Test Timeout With No Output (exceeded 10m0s): context deadline exceeded
- Record Limits in CircleCI's Flaky Tests API
- Troubleshooting General Issues with RSpec Testing
- Resolving Test Splitting Issues on macOS Xcode
- Rerun Failed Tests - Troubleshooting Parallel Run Failure
- Rerun Failed Tests - All Tests Still Being Rerun
- Troubleshooting failed test results upload with "invalid top level element" error
- Your test tools are smart and that’s a problem. Learn about when optimization goes wrong.
- Why do my tests take longer to run on CircleCI than locally?
- Remote Docker caching errors - only first few tests run
- Troubleshooting "invalid testcase element" error when uploading test results
- Why Do My Tests Pass Locally but Fail on CircleCI?
- Get Tagged in CircleCI Slack Build NotificationsHow to link your CircleCI account to Slack so you get @-mentioned in build notifications for workflows you triggered.
- CircleCI Feature Releases: Preview, Beta, and General Availability
- How to Deploy a CircleCI Configuration to Multiple GitHub Repositories
- Example: Using envsubst to populate CircleCI Project IDs for Release Agent
- npm is seeing error code E401 / 401 unauthorized from NPM registry
- Error: unknown command "run" for "circleci" when using Deploy Markers
- AWS CLI Fails with "TypeError: unsupported operand type(s) for -=: 'Retry' and 'int'"
- Deploy to Heroku via circleci/heroku Orb fails with "fatal: protocol error"
- Wrong AWS credentials being used
- Using AWS CodeDeploy with CircleCI 2.0 or CircleCI 2.1
- How to get a tag commit in CircleCI
- AWS and Docker Authorized Issues
- CircleCI CLI Fails With "panic: yaml: line 4: could not find expected ':'" Error
- circleci config validate fails when using pipeline values
- Checkout Private Repositories with CircleCI CLI Local Execution
- How to Identify your Organization's claimed namespace using the CircleCI CLI
- How to Resolve "invalid character 'I' looking for beginning of value" Error in CircleCI CLI
- How to delete a project's Docker Layer Cache
- How to validate a config that uses private Orbs
- How to resolve error: "--storage-opt is supported only for overlay over xfs with 'pquota' mount option" when running jobs locally with the cli
- CircleCI CLI - Running circleci local execute Results in "not implemented for cgroup v2 unified hierarchy" Error
- CircleCI Skills for Claude Code and CodexInstall and use CircleCI Skills, a plugin for Claude Code and Codex. Its Agent Skills let AI coding agents debug failing builds, optimize CI config, run the CLI, set up…
- Orb create fails with "this name is invalid" on CircleCI CLI preview (v1.x)
- Error: 'Workflow must be in a terminal state to be rerun' When Using the Rerun API
- Using the Current Concurrency Snapshot Script
- Who Approved My Approval Job?
- Insights API Endpoints Not Returning Data
- Why Is all_commit_details Missing Commits?
- Unique Naming for Personal API Tokens
- Retrieving job step output via the API
- Utilizing Python for the Usage API
- Usage API vs. Insights
- Calls to the CircleCI API Fail Intermittently With a 404
- Is there a way to get a project's additional SSH keys via the API?
- How to list in-progress pipelines for a given project
- How to programmatically set up a CircleCI project
- How To: Get Last Successfully Built Commit for Branch
Settings and Integration
Settings that can be changed from the CircleCI UI
- Is my project setup using GitHub OAuth or GitHub Apps?
- Using context with the Build pull requests from forked repositories
- Commits showing up as incorrect user
- Why Does My Commit Appear To Come From a Wrong/Different User?
- How to Checkout Code from Additional Repositories
- Troubleshooting Unable to Access Organization with Third-Party Restrictions Enabled
- $CIRCLE_PULL_REQUEST is missing from my Pull Request
- What is the difference between the versions 1.x and 2.x of the Jira orb
- Why can't I reset my password?
- Why is GitHub Missing From My Account Integration Tab?
- Do I Have To Send a New Team Invite For Every Project?
- Accidentally Removed My GH App Trigger in Project Settings
- Why do force pushes that change repository history cause problems on CircleCI?
- Troubleshooting pull requests from fork of private repository are failing at checkout step
- How to delete branches from CircleCI that were deleted from my VCS?
- Troubleshooting CircleCI VSCode Plugin
- Using FIPS Endpoints
- Using CircleCI with GitHub Enterprise
- How to view your GitLab Webhook Deliveries
- How do I remove members from my Gitlab organization?
- How do I add members to my Gitlab organization?
- Unable to update an organization's security settings and plans page
- My GitHub Organization Is Not Listed
- Why is an organization I am not a member of listed in the UI?
- How to remove legacy AWS integration secrets
- How to import Environment Variables from another project
- Unable to Follow Project: (HTTP Error 422)
- How Do I Add a Bitbucket User Key?
- How to Disable Resource Class Brownouts
- GitHub Merge Queue Compatibility with CircleCI
- Troubleshooting adding GitHub App to an organization with GitHub OAuth
- Troubleshoot Access/Set Up of SAML SSO in CircleCI
- How To View Your Bitbucket Webhook Deliveries
- How to Set Up a New GitHub OAuth App Organization
- How to Enable Dark Mode in CircleCI Web App
- Blocking Builds Org-wide through Config Policies
- Generate New GitHub OAuth Webhook
- Missing job is included in the GitHub check
- Forked Private Repositories Do Not Show in Project List
- Can I Limit CircleCI's Permissions Required To Access My VCS Provider?
- Getting Started with GitHub SSO
- How do I manage my People Settings for my GitHub organization?
- No pipelines are listed even after setting up project
- How to Unfollow a Project
- CircleCI Feature Releases: Preview, Beta, and General Availability
- Renaming and Transferring your Organization or Repository on your VCS
- How to Set Up a GitLab Organization
- Creating an access token in BitBucket to integrate CircleCI with BitBucket Data Center
- Updating Bitbucket User Avatars in CircleCI UI
- How to rename a project
- I No Longer Want To Be a Part Of An Organization in CircleCI
- How do I inspect the values of my environment variables in a job?
- Clickable links in step output
- Troubleshooting CircleCI Access After Enabling Github SSO
- VCS Default Branch Isn't Reflected on CircleCI
- How to stop building by manually removing the CircleCI webhook and deploy key from your Bitbucket repository
- How to stop building by manually removing the CircleCI webhook and deploy key from your GitHub repository
- How to generate and store read/write SSH keys
- "event cannot have more than 20 hooks" response
- The built-in environment variable CIRCLE_TAG is not being set
- Still Receiving Workflow Notification Emails After Disabling Them
- Understanding CircleCI Email Notification Preferences
- How to Unfollow a Project
- Notification Email Links Hang and Do Not Redirect to the CircleCI Workflow
- How to send a slack notification at end of workflow
- How to auto comment on GitHub Pull Requests
- Jira Notification Orb Fails with "You must log in first."
- How Do I Stop Getting Build Notification Emails For Projects?
- How to Find Your Organization in Notification Settings
- How to unsubscribe from SMS text message alerts for status.circleci.com
- Adding Additional Contacts
- Adding Additional Contacts
- How Do I Opt Out of Communications from CircleCI?
- Disabled Status Checks, but CircleCI is Still Reporting Status Checks
- How to disable legacy Slack integration
- Slack DMs for Your CircleCI WorkflowsLearn how to receive Slack direct message notifications for CircleCI workflow runs you trigger, including failed, on hold, and actor-tagged build alerts.