Skip to main content

Installation

PMDaemon is fully cross-platform and can be installed on Linux, Windows, and macOS through multiple methods. Choose the one that works best for your environment.

Prerequisites​

  • Rust 1.70+ (for building from source)
  • Operating System: Linux, macOS, or Windows (full native support)
  • Architecture: x86_64 or ARM64 (Apple Silicon supported)

The easiest way to install PMDaemon is using Cargo:

cargo install pmdaemon

This will:

  • Download and compile the latest stable version
  • Install the pmdaemon binary to ~/.cargo/bin/
  • Make it available in your PATH (if Cargo is configured correctly)

Verify Installation​

pmdaemon --version
# Output: pmdaemon 0.1.2

Method 2: Build from Source​

For the latest development version or custom builds (works on all platforms):

# Clone the repository
git clone https://github.com/entrepeneur4lyf/pmdaemon.git
cd pmdaemon

# Build in release mode (native platform)
cargo build --release

Platform-specific installation:

Linux/macOS:

sudo cp target/release/pmdaemon /usr/local/bin/

Windows:

copy target\release\pmdaemon.exe C:\Windows\System32\

Cross-Platform Building​

You can also build for other platforms:

# Add cross-compilation targets
rustup target add x86_64-pc-windows-gnu
rustup target add x86_64-apple-darwin
rustup target add aarch64-apple-darwin

# Build for Windows (from Linux)
cargo build --release --target x86_64-pc-windows-gnu

# Build for macOS (requires macOS machine)
cargo build --release --target x86_64-apple-darwin
cargo build --release --target aarch64-apple-darwin

Development Build​

For development or testing:

# Build in debug mode (faster compilation)
cargo build

# Run directly
./target/debug/pmdaemon --help

Method 3: Pre-built Binaries​

Download platform-specific pre-built binaries from the GitHub Releases page:

Linux (x86_64)​

wget https://github.com/entrepeneur4lyf/pmdaemon/releases/latest/download/pmdaemon-linux-x86_64
chmod +x pmdaemon-linux-x86_64
sudo mv pmdaemon-linux-x86_64 /usr/local/bin/pmdaemon

Windows (x86_64)​

# Download pmdaemon-windows-x86_64.exe
# Place in a directory in your PATH, or:
copy pmdaemon-windows-x86_64.exe C:\Windows\System32\pmdaemon.exe

macOS Intel (x86_64)​

wget https://github.com/entrepeneur4lyf/pmdaemon/releases/latest/download/pmdaemon-macos-x86_64
chmod +x pmdaemon-macos-x86_64
sudo mv pmdaemon-macos-x86_64 /usr/local/bin/pmdaemon

macOS Apple Silicon (aarch64)​

wget https://github.com/entrepeneur4lyf/pmdaemon/releases/latest/download/pmdaemon-macos-aarch64
chmod +x pmdaemon-macos-aarch64
sudo mv pmdaemon-macos-aarch64 /usr/local/bin/pmdaemon

Method 4: Package Managers​

Package Managers (Not Yet Available)​

PMDaemon is currently pre-1.0 and not yet available through package managers. Use the binary downloads or build from source above.

Configuration Setup​

After installation, PMDaemon will create its configuration directories on first run:

# Linux/macOS
~/.config/pmdaemon/
~/.local/share/pmdaemon/logs/
~/.local/share/pmdaemon/pids/

# Windows
%APPDATA%\pmdaemon\
%LOCALAPPDATA%\pmdaemon\logs\
%LOCALAPPDATA%\pmdaemon\pids\

Verify Installation​

Test that PMDaemon is working correctly:

# Check version
pmdaemon --version

# View help
pmdaemon --help

# Start a simple process
pmdaemon start "echo 'Hello PMDaemon'" --name test

# List processes
pmdaemon list

# Clean up
pmdaemon delete test

Troubleshooting​

Command Not Found​

If you get command not found: pmdaemon:

  1. Check Cargo bin directory is in PATH:

    echo $PATH | grep -q "$HOME/.cargo/bin" && echo "✓ Cargo bin in PATH" || echo "✗ Add ~/.cargo/bin to PATH"

  2. Add to PATH (add to your shell profile):

    export PATH="$HOME/.cargo/bin:$PATH"

  3. Reload shell:

    source ~/.bashrc  # or ~/.zshrc

Permission Denied​

If you get permission errors:

# Make binary executable
chmod +x /path/to/pmdaemon

# Or install to user directory
mkdir -p ~/.local/bin
cp pmdaemon ~/.local/bin/
export PATH="$HOME/.local/bin:$PATH"

Build Errors​

Common build issues:

  1. Rust version too old:

    rustup update

  2. Missing system dependencies (Linux):

    # Ubuntu/Debian
    sudo apt update
    sudo apt install build-essential pkg-config libssl-dev

    # CentOS/RHEL
    sudo yum groupinstall "Development Tools"
    sudo yum install openssl-devel

  3. Windows build tools:

Updating PMDaemon​

From Crates.io​

cargo install pmdaemon --force

From Source​

cd pmdaemon
git pull origin main
cargo build --release
sudo cp target/release/pmdaemon /usr/local/bin/

Uninstalling​

Cargo Installation​

cargo uninstall pmdaemon

Manual Installation​

# Remove binary
sudo rm /usr/local/bin/pmdaemon

# Remove configuration (optional)
rm -rf ~/.config/pmdaemon
rm -rf ~/.local/share/pmdaemon

Next Steps​

Now that PMDaemon is installed:

  1. Quick Start - Get up and running in 5 minutes
  2. CLI Commands - Learn the available commands
  3. Configuration - Set up configuration files

Need help? Check the troubleshooting guide or open an issue.