Deployed 56cd9a4 to 0.7.0 with MkDocs 1.6.1 and mike 1.1.2

Author: fvanroie

0.7.0/commands/index.html

@@ -5455,7 +5455,7 @@ <h3 id="screenshot"><code>screenshot</code><a class="headerlink" href="#screensh
 <p>Saves a picture of the current screen to the flash filesystem. You can retrieve it via http://&lt;ip-address&gt;/screenshot.bmp.
 This can be handy for bug reporting or documentation.</p>
 <p>The previous screenshot is overwritten.</p>
-<p>On the <strong>Mac desktop build</strong>, the screenshot is saved as <code>screenshot.bmp</code> in the working directory. You can optionally pass a custom file path as a parameter. Press <strong>F12</strong> in the simulator window as a shortcut.</p>
+<p>On the <strong>desktop builds</strong> (Mac, Linux, and headless), the screenshot is saved as <code>screenshot.bmp</code> in the working directory. You can optionally pass a custom file path as a parameter. Press <strong>F12</strong> in the simulator window as a shortcut (windowed builds only).</p>
 <h3 id="service"><code>service</code><a class="headerlink" href="#service" title="Permanent link">~</a></h3>
 <p>Start or stop some of the processes running on the plate.</p>
 <p>Currently supported parameters:</p>

0.7.0/commands/system/index.html

@@ -5226,10 +5226,14 @@ <h2 id="screenshot"><code>screenshot</code><a class="headerlink" href="#screensh
 <p>Saves a picture of the current screen to the flash filesystem. You can retrieve it via http://&lt;ip-address&gt;/screenshot.bmp.
 This can be handy for bug reporting or documentation.</p>
 <p>The previous screenshot is overwritten.</p>
-<p>On the <strong>Mac desktop build</strong>, the screenshot is saved as <code>screenshot.bmp</code> in the working directory. You can optionally pass a custom file path as a parameter.</p>
+<p>On the <strong>desktop builds</strong> (Mac, Linux, and headless), the screenshot is saved as <code>screenshot.bmp</code> in the working directory. You can optionally pass a custom file path as a parameter.</p>
 <div class="admonition tip">
 <p class="admonition-title">Tip</p>
-<p>Press <strong>F12</strong> in the simulator window to take a screenshot without using MQTT.</p>
+<p>Press <strong>F12</strong> in the simulator window to take a screenshot without using MQTT (windowed builds only).</p>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Headless build</p>
+<p>The <code>linux_headless</code> build supports screenshots via MQTT without any display server or SDL2 dependency. This makes it suitable for CI/CD pipelines, Docker containers, and headless servers.</p>
 </div>
 <h2 id="service"><code>service</code><a class="headerlink" href="#service" title="Permanent link">~</a></h2>
 <p>Start or stop some of the processes running on the plate.</p>

0.7.0/firmware/compiling/local/index.html

@@ -3196,6 +3196,17 @@
     </span>
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#headless-linux-build" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Headless Linux build
+      
+    </span>
+  </a>
+  
 </li>
 
           <li class="md-nav__item">
@@ -5108,6 +5119,17 @@
     </span>
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#headless-linux-build" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Headless Linux build
+      
+    </span>
+  </a>
+  
 </li>
 
           <li class="md-nav__item">
@@ -5232,10 +5254,25 @@ <h3 id="mcu-environments">MCU Environments<a class="headerlink" href="#mcu-envir
 <p><img alt="Build All" src="../images/build_all.png" /></p>
 <p>You can now run "Build" or "Build All" in PlatformIO to compile (all) the firmware.</p>
 <h3 id="native-linux-build">Native Linux build<a class="headerlink" href="#native-linux-build" title="Permanent link">~</a></h3>
-<p>For native linux_sdl builds, you also need:
+<p>For native <code>linux_sdl</code> builds (with GUI window), you also need:
 <div class="highlight"><pre><span></span><code>sudo apt update
 sudo apt install build-essential libsdl2-dev
 </code></pre></div></p>
+<h3 id="headless-linux-build">Headless Linux build<a class="headerlink" href="#headless-linux-build" title="Permanent link">~</a></h3>
+<p>The <code>linux_headless</code> build runs without any display server or SDL2 dependency. It uses a null display driver with an in-memory framebuffer, making it ideal for CI/CD pipelines, Docker containers, and headless servers. Screenshots are captured via MQTT.</p>
+<p>No extra system packages are needed beyond a C++ compiler:
+<div class="highlight"><pre><span></span><code>sudo apt update
+sudo apt install build-essential
+</code></pre></div></p>
+<p>Uncomment <code>user_setups/linux/*.ini</code> in your <code>platformio_override.ini</code>, then:
+<div class="highlight"><pre><span></span><code>pio run -e linux_headless
+</code></pre></div></p>
+<p>Run the headless binary:
+<div class="highlight"><pre><span></span><code>./program -c /path/to/config
+</code></pre></div></p>
+<p>Take a screenshot via MQTT:
+<div class="highlight"><pre><span></span><code>mosquitto_pub -t &quot;hasp/&lt;plate&gt;/command/screenshot&quot; -m &quot;/path/to/screenshot.bmp&quot;
+</code></pre></div></p>
 <h3 id="native-macos-build">Native MacOS build<a class="headerlink" href="#native-macos-build" title="Permanent link">~</a></h3>
 <p>For native darwin_sdl builds, you also need <a href="https://brew.sh">Homebrew</a>:</p>
 <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>brew<span class="w"> </span>install<span class="w"> </span>gcc<span class="w"> </span>sdl2