Start Building for Free

Orbs FAQ

11 months ago1 min read
Server v4.x
Server v3.x
On This Page

This document describes various questions and technical issues that you may find helpful when working with orbs.


Can orbs be made private?

Private orbs are available on any of our current plans.

What is the difference between commands and jobs?

Both commands and jobs are elements that can be used within orbs.

Commands contain one or many steps, which contain the logic of the orb. Commands generally execute some shell code (bash).

Jobs are a definition of what steps/commands to run and the executor to run them in. Jobs invoke commands, and are orchestrated using workflows.

Can orbs be used on a private installation of CircleCI server?

Orbs can be used with installations of CircleCI server. For information on importing and using orbs for server, see the CircleCI server managing orbs page.

How can I report a bug or issue with a public orb?

All public orbs are open source projects. Issues, bug reports, or even pull requests can be made against the orb’s git repository. Public orb authors may opt to include a link to the git repo on the orb registry. If the git repo link is unavailable, contact support and we will attempt to contact the author. Alternatively, consider forking the orb and publishing your own version.

How do I use the latest version of an orb?

Orbs use semantic versioning, meaning if you set the major version (example: 3), you will receive all minor and patch updates, where if you statically set the version (example: 3.0.0), no updates will apply, this is the most deterministic and recommended method.

See also

Suggest an edit to this page

Make a contribution
Learn how to contribute