SMOKEPING_CGI(1)

📦
version 2.9.0 · 12 versions
, in alpine 3.23, alpine 3.24

💅 SMOKEPING_CGI(1) — the SmokePing webfrontend, bestie

okay so real talk, this one's from the SmokePing manual section, and it's literally the page for smokeping_cgi 💖

✨ NAME ✨

smokeping_cgi — the SmokePing webfrontend, no cap 🎀

🌸 OVERVIEW 🌸

So basically this script is the "website" for your whole SmokePing monitoring situation 👑 It takes the targets you're watching and shows them off in a tree structure, and then it draws graphs on demand — like, whenever somebody actually needs to look at one 🖼️✨

🦋 DESCRIPTION 🦋

To get smokeping_cgi up and running, you need a webserver that lets you run CGI or — highkey better — FastCGI scripts. The system has to be set up so that the cgi process is allowed to write to the image caching area as defined in the config file 📝 (yes, it needs write access, don't @ me, it's literally in the config)

This script runs fine as a normal CGI, BUT — and hear me out — it will appear to be very slow 😭 because it does a loooot of things when starting up. So if the script has to be started fresh on every single click, that's both slow and a tough thing for your webserver to deal with. So I therefore strongly recommend using FastCGI ⚡ periodt.

💡 Please refer to the installation document for detailed setup instructions — it's all there, iykyk.

🎀 SETUP 🎀

There's a sample htdocs directory in your smokeping installation root 📁 Copy its content to the place where your webserver expects its files.

The fcgi script shows the preferred method for running smokeping ✨ You can also run smokeping as a cgi. But make sure to still use the wrapper — because exposing ARGV to the webserver represents a security vulnerability you may rather not want to deal with 💀 like, fr fr, don't skip the wrapper.

Adjust the paths in the script and you should be ready to go 🚀

🌈 SEE ALSO 🌈

Copyright (c) 2011 by Tobias Oetiker. All right reserved.

📜 LICENSE 📜

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details 🫶

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

👑 AUTHOR 👑

Tobias Oetiker <tobi@oetiker.ch> 🧚

okay that's the whole page, bestie, you're so welcome 💖 this was SmokePing 2.9.0, dated 2025-06-30 — slay, go set up your FastCGI now 🌸✨🦋

📦 where this page comes from