npm Mirror Iran — Node.js Registry

npm-group

Standard npm registry

Implements the npm registry API. Set it as your registry and every install resolves through Kargadan.

4 tools

npm, pnpm, Bun, Yarn

Anything that reads .npmrc or accepts a registry URL works without modification.

CI ready

No tokens, no rate limits

Designed for build runners, container images, and ephemeral environments. Authentication is not required.

Registry URL

This is the canonical registry URL. Use it everywhere a package manager asks for one.

HTTPS · recommended

https://mirror.kargadan.ir/repository/npm-group/

HTTP · legacy clients only

http://mirror.kargadan.ir/repository/npm-group/

Quick start

One-shot install

npm install lodash \
  --registry https://mirror.kargadan.ir/repository/npm-group/

Set as default registry (recommended)

npm config set registry https://mirror.kargadan.ir/repository/npm-group/

# Verify
npm config get registry

Per-project (.npmrc)

Create .npmrc in your project root:

registry=https://mirror.kargadan.ir/repository/npm-group/

Per-tool configuration

npm

npm config set registry https://mirror.kargadan.ir/repository/npm-group/
npm install express mongoose dotenv

pnpm

pnpm config set registry https://mirror.kargadan.ir/repository/npm-group/
pnpm install

Bun

# Bun reads .npmrc
echo "registry=https://mirror.kargadan.ir/repository/npm-group/" >> .npmrc
bun install

Yarn 1 (Classic)

yarn config set registry https://mirror.kargadan.ir/repository/npm-group/
yarn add react react-dom

Yarn 2+ (Berry)

See the dedicated Yarn guide for the Berry-specific config keys.

Framework starters

Set the registry once, then use the standard create-* scaffolds:

npm config set registry https://mirror.kargadan.ir/repository/npm-group/

npx create-next-app@latest my-next-app
npx create-react-app   my-react-app
npm  create vue@latest my-vue-app
npx create-remix@latest my-remix-app

Docker example

FROM node:22-alpine
WORKDIR /app

RUN npm config set registry https://mirror.kargadan.ir/repository/npm-group/

COPY package*.json ./
RUN npm ci --omit=dev

COPY . .
EXPOSE 3000
CMD ["node", "index.js"]

CI / CD

GitHub Actions

name: Build
on: [push]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
          registry-url: 'https://mirror.kargadan.ir/repository/npm-group/'
      - run: npm ci
      - run: npm test

GitLab CI

build:
  image: node:22
  before_script:
    - npm config set registry https://mirror.kargadan.ir/repository/npm-group/
  script:
    - npm ci
    - npm run build

Mirror information

Mirror type	Group Aggregated
Upstream sources	Chabokan, Pardisco, Jamko, Runflare, registry.npmjs.org
Protocols	HTTPS · HTTP
Authentication	Not required (anonymous)

Monorepo tip

For npm, pnpm, or Yarn workspaces, set the registry once in the root .npmrc. Every workspace package will inherit it automatically.