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.
- Config
- Jenkinsfile
- Token
- Secret text credential cacheport-token
- Binding
- credentials() in environment
- Network
- One outbound host: acme.cacheport.cc
Give your pipelines a token
Create a Secret text credential with the ID cacheport-token, then bind it in the pipeline.
environment {
CACHEPORT_TOKEN = credentials('cacheport-token')
}Examples
Copy-ready configuration for common setups.
npm
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
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
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.
FAQ
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.
Other CI providers
Setting up somewhere else too?
Start on the free plan
20 GB of cache, every registry, unlimited users. Upgrade when your pipelines outgrow it.