# decap-server

> Proxy server for the Decap CMS proxy backend. Now `decap dev`; this package runs the same server.

Latest version **3.11.6** (published 2026-10-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install decap-server
pnpm add decap-server
yarn add decap-server
bun add decap-server
```

Provides the command `decap-server`.

## Health

**Score 65/100 (B)** — status: active.

Positive: no vulnerabilities; has provenance; recently updated; high maintenance score; popular repo.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 3.11.6 |
| Published | 2026-10-26 |
| First published | 2023-08-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=20 |
| Dependencies | 1 |
| Unpacked size | 25.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 19460 |
| Maintainers | demshy, poslovnimediji, martinjagodic, samofab |
| Keywords | decap-cms, backend |

## Links

- npm: https://www.npmjs.com/package/decap-server
- Repository: https://github.com/decaporg/decap-cms/tree/main/packages/decap-server
- Issues: https://github.com/decaporg/decap-cms/issues
- npm.io page: https://npm.io/package/decap-server

## Dependencies (1)

- [@decap/cli](https://npm.io/package/@decap/cli.md) 0.1.3

## Recent versions

- 3.11.6 (latest) — 2026-10-26
- 3.11.5 (beta) — 2026-10-14
- 3.11.4 — 2026-10-14
- 3.11.4-beta.2 — 2026-10-13
- 3.11.3-beta.2 — 2026-10-08
- 3.11.3-beta.1 — 2026-09-22
- 3.11.3 — 2026-09-22
- 3.11.3-beta.0 — 2026-09-10
- 3.11.2 — 2026-09-10
- 3.11.1 — 2026-09-08
- 3.11.0 — 2026-08-31
- 3.10.0 — 2026-07-23
- 3.9.1 — 2026-06-15
- 3.9.0 — 2026-06-08
- 3.8.0 — 2026-06-01
- … 19 more at https://npm.io/package/decap-server/versions

## README

# decap-server

The local proxy server for Decap CMS's `proxy` backend. Run it in the root of your site's repository and the CMS reads and writes files on disk instead of going through a git host:

```sh
npx decap-server
```

The CMS side needs only:

```yaml
local_backend: true
```

It needs Node 20 or later.

Settings are read from the environment, also from a `.env` file in the working directory: `PORT` (default 8081), `BIND_HOST` (default this machine only; the server has no authentication, so only set `0.0.0.0` or another network address on a network you trust, e.g. inside a container), `MODE` (`fs` or `git`, default `fs`), `GIT_REPO_DIRECTORY` (default the current directory), `ORIGIN` (default localhost and 127.0.0.1) and `LOG_LEVEL` (default `info`). In `git` mode changes are committed to the local repository and the editorial workflow works.

To mount the endpoints on your own Express app:

```js
const { registerLocalFs, registerLocalGit } = require('decap-server/dist/middlewares');
```

Since 3.11.4 the server code lives in the internal `@decap/cli` package, which this package depends on and runs. Nothing changes for `npx decap-server` users.

---
_Source: https://npm.io/package/decap-server · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._