PushDeploy

PushDeploy is our own deployment tool for Node.js applications and static websites on self-hosted servers. Born from daily practice, it solves a common problem: How do I reliably and repeatably deploy my application to my server — without setting up complex CI/CD pipelines?

The Problem

Many teams run their own servers — be it a Raspberry Pi, VPS, or dedicated hardware. But deployment often remains manual: SSH sessions, rsync scripts, forgotten build steps. PushDeploy puts an end to that.

How It Works

The workflow is intentionally simple:

• Set up the agent on your server — an npm package, installed via script
• Link your project locally with a token
• "pushdeploy project deploy" — done

Features

• Zero-downtime deployments with atomic symlink switches
• Automatic release management with rollback capability
• Support for Node.js services and static sites
• Integrated secret management for environment variables
• Git-based push mechanism — no separate artifact store needed
• CLI tool for local developers and CI/CD integration

Architecture

PushDeploy consists of two components: a lightweight agent on the server and a CLI tool for developers. Communication runs over HTTPS with token-based authentication.

• Server agent: Node.js service with REST API
• CLI: Local tool for developers — npm-installable
• Git push for artifact transfer — proven infrastructure
• Systemd integration for service management

In Production

PushDeploy runs all our production websites and APIs — from symbioware.de to kairox.de to club websites. It is not a playground, but proven in daily use.