cacheport

CI provider

Cacheport with Jenkins

Jenkins agents often run behind corporate firewalls and share one outbound address. Cacheport gives them a single allowed host for every registry and keeps public rate limits out of the picture.

CI · JENKINSManifest
Config
Jenkinsfile
Token
Secret text credential cacheport-token
Binding
credentials() in environment
Network
One outbound host: acme.cacheport.cc

Give your pipelines a token

Store the token as a credential

Create a Secret text credential with the ID cacheport-token, then bind it in the pipeline.

Jenkinsfile
environment {
  CACHEPORT_TOKEN = credentials('cacheport-token')
}

Examples

Copy-ready configuration for common setups.

npm

Jenkinsfile
pipeline {
  agent { docker { image 'node:22' } }
  environment {
    CACHEPORT_TOKEN = credentials('cacheport-token')
    NPM_CONFIG_REGISTRY = 'https://acme.cacheport.cc/npm/'
  }
  stages {
    stage('Install') {
      steps {
        sh 'echo "//acme.cacheport.cc/npm/:_authToken=${CACHEPORT_TOKEN}" > .npmrc'
        sh 'npm ci'
      }
    }
  }
}

Maven

Jenkinsfile
pipeline {
  agent { docker { image 'maven:3.9-eclipse-temurin-21' } }
  environment {
    CACHEPORT_TOKEN = credentials('cacheport-token')
  }
  stages {
    stage('Build') {
      steps {
        sh 'mvn -s .mvn/settings.xml -B verify'
      }
    }
  }
}

Docker agents from the cache

Jenkinsfile
pipeline {
  agent {
    docker {
      image 'acme.cacheport.cc/hub/library/python:3.13'
      registryUrl 'https://acme.cacheport.cc'
      registryCredentialsId 'cacheport-registry'
    }
  }
  stages {
    stage('Test') { steps { sh 'pytest' } }
  }
}

Firewalled agents

Instead of opening outbound access to a dozen registries and their CDNs, allow one host. Every ecosystem, image registry and build cache is reachable through acme.cacheport.cc.

Questions

Does it replace a Nexus or Artifactory instance?

For caching public packages, yes. If you also host internal artifacts, keep your repository manager and add it as an upstream.

Can agents use an IP allowlist instead of a token?

Yes. Business and Enterprise workspaces can allow fixed IP ranges for read access.

Do single quotes in sh steps matter?

Yes. Single quotes let the shell expand the credential, so Groovy never interpolates the secret into the build log.

Setting up somewhere else too?

Start on the free plan

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