cacheport

CI provider

Cacheport with CircleCI

CircleCI runs jobs in parallel containers that each download dependencies. Store a Cacheport token in a context and every job pulls from the same regional cache.

CI · CIRCLECIManifest
Config
.circleci/config.yml
Token
Context variable CACHEPORT_TOKEN
Images
Docker executor auth for the image cache
Parallelism
All parallel containers share one cache

Give your pipelines a token

Store the token in a context

Contexts share variables between projects and can be restricted to security groups.

shell
$ cacheport token create circleci --scope read
# CircleCI: Organization Settings > Contexts > cacheport
# Add variable CACHEPORT_TOKEN

Examples

Copy-ready configuration for common setups.

npm

.circleci/config.yml
version: 2.1
jobs:
  test:
    docker:
      - image: cimg/node:22.11
    steps:
      - checkout
      - run: |
          echo "registry=https://acme.cacheport.cc/npm/" > .npmrc
          echo "//acme.cacheport.cc/npm/:_authToken=${CACHEPORT_TOKEN}" >> .npmrc
      - run: npm ci
      - run: npm test
workflows:
  main:
    jobs:
      - test:
          context: cacheport

pip

.circleci/config.yml
jobs:
  test:
    docker:
      - image: cimg/python:3.13
    steps:
      - checkout
      - run: |
          export PIP_INDEX_URL="https://ci:${CACHEPORT_TOKEN}@acme.cacheport.cc/pypi/simple/"
          pip install -r requirements.txt
          pytest

Images from the cache

.circleci/config.yml
jobs:
  test:
    docker:
      - image: acme.cacheport.cc/hub/library/postgres:17
        auth:
          username: ci
          password: $CACHEPORT_TOKEN

Parallel and matrix jobs

Test splitting runs the same install step in many containers at once. Without a shared cache each container downloads everything separately; with Cacheport, the first container warms the cache and the rest hit it.

Questions

Should I keep restore_cache?

Yes. restore_cache saves the copy step on a hit; Cacheport makes misses fast.

Does it work with machine executors?

Yes. Any executor with outbound HTTPS can use Cacheport.

Which region is closest?

CircleCI cloud runs mostly in US regions, so iad1 is usually the best choice.

Setting up somewhere else too?

Start on the free plan

20 GB of cache, every registry, unlimited users. Upgrade when your pipelines outgrow it.