# devpush

devpush is an open-source deployment platform for your own servers. Connect a GitHub repository, configure your Docker Compose app and push to deploy.

Run the dashboard on **Cloudflare Workers** or **Node**. A small Linux agent manages applications on your servers, including HTTPS, deployment logs, monitoring and backups. Teams, environments, encrypted variables, a REST API and MCP are included.

<a href="https://devpu.sh/videos/devpush-demo.mp4">
  <img src="https://devpu.sh/videos/readme-demo.png" alt="Watch the devpush demo" width="1200" />
</a>

## Get started

- [Install devpush](docs/self-hosting.md) on Cloudflare or with Docker Compose.
- [Deploy your first app](docs/getting-started.md) once your dashboard is running.
- [Read the documentation](docs/index.md) for configuration and operations.

Install with `npx devpush@latest init`. The wizard creates a standalone project using the [npm package](https://www.npmjs.com/package/devpush), configures your target and offers to deploy. For an existing project, see [Package integration](docs/package-installation.md).

Compose is required; Dockerfiles can be used within it. Updates happen in place and do not guarantee zero downtime. Only deploy trusted code: Docker workloads can access their host.

## Development

Requires Node.js 22.12+ and pnpm 10.17+:

```sh
pnpm install
pnpm configure
pnpm dev
```

Choose local development and open `http://localhost:7429`. See [Local development](docs/local-setup.md) for tests and the deployment VM, and [Contributing](docs/development.md) for code boundaries and plugins.

## License

[MIT](LICENSE.md). See [changes](CHANGELOG.md) and [planned work](TODO.md).