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.
415 articles
- Troubleshooting issues with special characters in environment variables
- Example CircleCI Projects & Language Guides
- Troubleshooting "Command Not Found" in Multi-Container Docker Jobs
- Troubleshooting CIRCLE_CONTINUATION_KEY is required. Make sure setup workflows are enabled.
- How to use branch filters with IP ranges
- How to Add Deprecated Debian Stretch Repositories
- How to Run the Same Job Twice in a Single Workflow
- CircleCI Associate Developer Certificate
- Can I change the value of circleci_ip_ranges based on the branch?
- Why is there an `analyze-my-code` workflow in my project?
- Understanding Exit Status Code 255
- How do I modify the checkout step?
- Pinning a Docker Image to a Specific Version
- How do I set the timezones in Docker images?
- Filter workflows by branch
- How to insert files as environment variables
- How to validate your CircleCI configuration
- Managing GitHub Authentication in Composer-Based Projects
- How to use pre and post steps with orb job commands
- How to use a Specific SSH Key for Git Clone
- Can I use environment variables in conditional statements?
- Understanding Jobs and Tasks in CircleCI
- Regex for Branch Filtering in CircleCI
- python3 Does Not Recognize Packages Installed With pip
- Understanding the "fatal: reference is not a tree" Error in Git
- Can I cache my dependencies on CircleCI?
- Source a bash file before every command
- Why is CIRCLE_PR_NUMBER empty?
- Why job names get a -1 or -3-1 suffixCircleCI config compilation can append numbers to job names when the same job is used more than once in a 2.1 config, including once per workflow.
- Available Docker versions
- Storing Secret Files (certs, etc.)
- Port conflicts with service containers on Docker executor
- Resolving: "CircleCI was unable to start the container"
- How to push a commit back to the same repository as part of the CircleCI job
- "Cannot add more than 100 environment variables to a context"
- Troubleshooting Error Message: "Max number of workflows exceeded."
- Adjust screen resolution on Windows executor
- We were unable to run this job. Please check your configuration and try again.
- Conditionally setting values in the config file
- How to authenticate multiple AWS profiles using OIDC
- Set a dated file name using environment variables
- Troubleshooting Error: "This job has been blocked because resource-class:2xlarge is not available on your plan. Please upgrade to continue building."
- Troubleshooting: Config Processing Error - "Don't rerun this job"
- How To Locate Your Repo Files When Using CircleCI
- Troubleshooting self hosted runner: ERRO[2400] error running task error on RedHat
- Use specific executor based on branch with dynamic configuration
- How to install iLok License Support Installer silently
- How to set resource class configuration for container runner
- Docker Executor returning Total Host CPU Cores
- How to pass environment variables between jobs
- How to set resources limits CPU and RAM (memory) for container runner
- How to execute a step in the background on CircleCI
- Setting and Using Environment Variables in the windows environment
- Adjust Ports on Windows Firewall for your Applications
- Troubleshooting checkout step failing - Alpine image
- How do I run Powershell as Another User?
- Accessing $BASH_ENV Results in "No such file or directory"
- How To Set Up a VPN Connection During Builds
- Enabling Docker Experimental Features on Remote Docker
- Troubleshooting "Job failed due to excessive parallelism"
- Resolving Cache Upload Errors and Stuck Cache Issues in CircleCI
- How to Trigger a Workflow Based on Environment Parameters in CircleCI
- Why serial-start Fails: Serial Group Priority
- CircleCI Audit Log Events Reference
- Blobless Checkout, and How to Opt In and Out
- How to Prevent Triggering Builds on Commit Pushes
- Seeing a build failure every day which I didn't set up
- Can I split a config into multiple files?
- Integers Longer Than 6 Digits Will Be Converted in Job Level Environment Variables
- How to ignore a failure in a step
- Setup Workflows re-run from UI fails with error: {"message":"Continuation key has expired. Please run a new pipeline."}
- Config file could not be found when using continuation orb
- Troubleshoot "The authenticity of host 'github.com' can't be established" message during job execution.
- Reducing iOS Simulator CPU Overhead on macOS Executors
- How to Fix Pipelines Page Performance
- "fork: retry: Resource temporarily unavailable" When Using Command Substitution in $BASH_ENV
- Git LFS Files Not Pulled During Checkout on Docker and Machine Executor Images
- When to use checkout: method: full (after blobless default)
- How to Clear the Date Filter on the Pipelines Dashboard
- Scheduled Pipeline Stopped Running After a Team Member Left
- Scheduled Pipeline Not Running When Using the Scheduled Actor
- Scheduled Pipeline Troubleshooting Checklist
- Troubleshooting "2 schema violations found required key [jobs] not found required key [version] not found"
- Which CircleCI Resources are made Available to Users on the Free Plan?
- How can I conditionally run a job if another job passes or fails?
- How to View the IP Address Used by Your Machine
- Resolving HEREDOC Errors in CircleCI YAML Configuration
- Update to Dynamic 'when' Statements in Workflows
- Adding Timestamps to Commands in CircleCI
- Troubleshooting OpenVPN timeouts in CircleCI workflows
- How to Retry a Failed Step with "when" Attribute?
- Maximum Size of a CircleCI Configuration File (config.yml)
- Does CircleCI support matrix config?
- Using Multiple Line(newline) Environment Variables in CircleCI
- Time-Limit for Approval/Hold Job
- Conditional steps in jobs and conditional workflows
- How to run a workflow when the previous one failed
- How to give a workflow a nickname
- How to Delete a Pipeline in CircleCI
- Order Workflows in CircleCI
- [Limited Availability]Introducing the AI Assisted Pipeline Editor
- Is There a Limit on the Number of Contexts I Can Have in a Config?
- Can I create pipeline for an external GitHub repo?
- Resolving Missing OIDC Token Issues in CircleCI
- How do I configure a pipeline in the UI?
- How to edit config.yml
- Using GitHub App Functionality in a GitHub OAuth App Organization
- How to solve the escaping character error
- Troubleshooting passing pipeline values within an orb to a job
- Directory with space in name not working for 'working_directory'
- 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-cli orb ignores CLI version pin / CLI 1.0 config process requires a tokenWhy circleci/[email protected] may install latest CLI despite a version parameter, how that interacts with CLI 1.0 authentication for config process, and workarounds.
- 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.