Skip to content
ViGrise Platform

Install from Binary

Pre-built binaries are available for Linux, macOS, and Windows. No Rust or build tools required.

Quick Start

Section titled “Quick Start”

Linux / macOS

Terminal window
curl -s -o- https://raw.githubusercontent.com/ViGrise/previewproxy/main/install.sh | sudo bash
previewproxy

Install use install.sh scripts, the binary placed at /usr/local/bin.

Windows

Terminal window
irm https://raw.githubusercontent.com/ViGrise/previewproxy/main/install.ps1 | iex
previewproxy

Install use install.ps1 scripts, the binary placed at %LOCALAPPDATA%\previewproxy\bin.

Open http://localhost:8080/health to confirm it’s running.

Download

Section titled “Download”

Go to the GitHub Releases page and download the archive for your platform.

Linux (x86_64)

Section titled “Linux (x86_64)”
Terminal window
curl -fsSL https://github.com/ViGrise/previewproxy/releases/latest/download/previewproxy-linux-x86_64 -o previewproxy
chmod +x previewproxy

Linux (arm64)

Section titled “Linux (arm64)”
Terminal window
curl -fsSL https://github.com/ViGrise/previewproxy/releases/latest/download/previewproxy-linux-arm64 -o previewproxy
chmod +x previewproxy

macOS (Apple Silicon)

Section titled “macOS (Apple Silicon)”
Terminal window
curl -fsSL https://github.com/ViGrise/previewproxy/releases/latest/download/previewproxy-darwin-arm64 -o previewproxy
chmod +x previewproxy

macOS (Intel)

Section titled “macOS (Intel)”
Terminal window
curl -fsSL https://github.com/ViGrise/previewproxy/releases/latest/download/previewproxy-darwin-x86_64 -o previewproxy
chmod +x previewproxy

Windows

Section titled “Windows”

Download previewproxy-windows-x86_64.exe from the releases page.

Run

Section titled “Run”
Terminal window
./previewproxy

Open http://localhost:8080/health to confirm it’s running.

Run as a systemd Service

Section titled “Run as a systemd Service”

To run PreviewProxy automatically on boot, create a systemd unit file:

Terminal window
sudo nano /etc/systemd/system/previewproxy.service

Paste the following:

[Unit]
Description=PreviewProxy
After=network.target


[Service]
ExecStart=/usr/local/bin/previewproxy
Restart=on-failure
Environment=PP_PORT=8080
Environment=PP_APP_ENV=production


[Install]
WantedBy=multi-user.target

Enable and start the service:

Terminal window
sudo systemctl daemon-reload
sudo systemctl enable previewproxy
sudo systemctl start previewproxy

Check the status:

Terminal window
sudo systemctl status previewproxy

Run as a Windows Service

Section titled “Run as a Windows Service”

Use NSSM (Non-Sucking Service Manager) to run PreviewProxy as a Windows service.

Install NSSM (via Chocolatey):

Terminal window
choco install nssm

Register the service:

Terminal window
nssm install PreviewProxy "C:\path\to\previewproxy-windows-x86_64.exe"
nssm set PreviewProxy AppEnvironmentExtra PP_PORT=8080 PP_APP_ENV=production
nssm start PreviewProxy

Manage the service:

Terminal window
nssm stop PreviewProxy
nssm restart PreviewProxy
nssm remove PreviewProxy confirm

Next Steps

Section titled “Next Steps”