Skip to main content

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.

406 articles

Configuring Pipelines

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

Building Projects

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?

Settings and Integration

Settings that can be changed from the CircleCI UI

CircleCI Feature Releases: Preview, Beta, and General Availability
How to Unfollow a Project
No pipelines are listed even after setting up project
How do I manage my People Settings for my GitHub organization?
Getting Started with GitHub SSO
Can I Limit CircleCI's Permissions Required To Access My VCS Provider?
Forked Private Repositories Do Not Show in Project List
Missing job is included in the GitHub check
How to Disable Resource Class Brownouts
Blocking Builds Org-wide through Config Policies
How to Enable Dark Mode in CircleCI Web App
How to Set Up a New GitHub OAuth App Organization
How To View Your Bitbucket Webhook Deliveries
Troubleshoot Access/Set Up of SAML SSO in CircleCI
Troubleshooting adding GitHub App to an organization with GitHub OAuth
GitHub Merge Queue Compatibility with CircleCI
Generate New GitHub OAuth Webhook
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
How to delete branches from CircleCI that were deleted from my VCS?
Troubleshooting pull requests from fork of private repository are failing at checkout step
Why do force pushes that change repository history cause problems on CircleCI?
Accidentally Removed My GH App Trigger in Project Settings
Do I Have To Send a New Team Invite For Every Project?
Why is GitHub Missing From My Account Integration Tab?
Why can't I reset my password?
Is my project setup using GitHub OAuth or GitHub Apps?
What is the difference between the versions 1.x and 2.x of the Jira orb
$CIRCLE_PULL_REQUEST is missing from my Pull Request
Troubleshooting Unable to Access Organization with Third-Party Restrictions Enabled
How to Checkout Code from Additional Repositories
Why Does My Commit Appear To Come From a Wrong/Different User?
Commits showing up as incorrect user
Using context with the Build pull requests from forked repositories
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?