Skip to content

Installation

Jump to bottom
Xbot-me edited this page Jun 23, 2026 · 1 revision

Installation

This page covers everything you need to get PulseDeploy running on a fresh server.

Requirements

Requirement Details
OS Ubuntu 20.04+, Debian 11+, Amazon Linux 2/2023, CentOS/Rocky 8/9
Access Root or sudo privileges
RAM Minimum 512MB (1GB+ recommended)
Disk Minimum 10GB free
Network Internet access to download packages

Step 1 — Clone the repo

git clone https://github.com/Xbot-me/PulseDeploy.git
cd PulseDeploy

Step 2 — Make scripts executable

chmod +x bootstrap.sh scripts/**/*.sh

Step 3 — Run as root

sudo bash bootstrap.sh

⚠️ Always run on a fresh server. Running on an existing production server may overwrite configs.

What happens next

The wizard walks you through 4 steps:

1. OS Detection (automatic)

PulseDeploy reads /etc/os-release and loads the correct OS module. No input needed.

[i] Detected OS: ubuntu 22.04

2. Stack Selection

Choose a server stack to install:

    

  1. LEMP  — Nginx + PHP-FPM + MySQL
    2. 

  2. LAMP  — Apache + PHP + MySQL
    3. 

  3. Node  — Nginx + Node.js (with PM2)
    4. 

  4. Skip  — Core services only

    5.

3. Services Toggle

You'll be asked yes/no for each optional service:

Install Redis? [y/N]:
Install Docker & Compose? [y/N]:
Configure UFW/firewall + fail2ban? [y/N]:
Install Certbot (SSL)? [y/N]:
Configure swap file? [y/N]:
Apply PHP-FPM performance tuning? [y/N]:

4. Confirmation Summary

A full summary is shown before anything is installed:

━━━ Installation Summary ━━━

OS           : ubuntu 22.04
Stack        : lemp
Redis        : ✔ Yes
Docker       : ✘ No
Firewall     : ✔ Yes
Certbot      : ✔ Yes
Swap         : ✔ Yes
PHP Tuning   : ✔ Yes


Proceed with installation? [y/N]:

Install log

Everything is logged to:

/var/log/server-bootstrap.log

If something fails, check this file first:

cat /var/log/server-bootstrap.log
tail -50 /var/log/server-bootstrap.log

One-liner for AWS / cloud-init

For automated provisioning via AWS EC2 user-data or cloud-init:

#!/bin/bash
git clone https://github.com/Xbot-me/PulseDeploy.git /opt/PulseDeploy
cd /opt/PulseDeploy
chmod +x bootstrap.sh scripts/**/*.sh
# Non-interactive mode coming soon — see Roadmap

Next steps

  • Stacks — detailed breakdown of LEMP, LAMP, Node.js
  • Services — Redis, Docker, Firewall, SSL, Swap, PHP tuning
  • AWS EC2 Guide — EC2-specific setup
  • Troubleshooting — if something went wrong

Clone this wiki locally