A 0 dependency, simple, deployment server that works with github webhooks

1. Copy config.json.example to config.json: cp config.json.example config.json
2. Change the permissions of this config file so other users can't see it: chmod 600 config.json
3. Open an editor to edit this file, like nano config.json or vi config.json

• SECURE_SERVER: Set it to true if do you wish to listen for webhook over HTTPS (not necessary if deployer is already behind a reverse proxy with HTTPS)
• PRIVATE_KEY: Required if SECURE_SERVER is true, the path to the private key
• CERT: Required if SECURE_SERVER is true, the path to the cert
• PORT: The desired port that will be used to listen for webhooks
• projects: An array of project objects

{
      "repository": "user-or-org/repo-name",
      "branchToDeploy": "master",
      "secret": "superscretsecret",
      "tasks": [
        "/path/to/script.sh"
      ]
    }

• repository: For this project, the value would be eduardozgz/deployer
• branchToDeploy: The desired branch to be deployed, this is usually master or main
• secret: This is like a password, choose something strong and never share it
• tasks: An array of strings, as value, the path to the installation scripts for your project, a script would look like this:

#!/bin/bash
cd /path/to/your/project
npm install && systemctl restart your-app.service

Go to your repository settings on github, go to webhooks and add one

As payload URL, add the host where deployer is running (remember to open the firewall if it's necessary)

Change the content type to application/json

Enter the secret that you used in the config.json

And add the webhook

Run node . Or pm2 start deployer and save the process list pm2 save