https://sow.pgsty.com/tags/filesystem/ Recent content in filesystem on SOW Hugo en Fri, 28 Aug 2026 18:32:04 +0800 https://sow.pgsty.com/docs/tutorial/serving/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/docs/tutorial/serving/ <p>SOW writes static files; it is not an HTTP server. This guide keeps the writable Workspace separate from the path Nginx serves.</p> <h2 id="public-and-private-paths">Public and private paths </h2> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">Mode</th> <th scope="col">Public unit</th> <th scope="col">Never serve</th> </tr> </thead> <tbody> <tr> <td>Plain</td> <td>the directory passed to <code>sow create</code></td> <td>transient <code>.sow-plain-stage-*</code> output; no durable journal</td> </tr> <tr> <td>Managed</td> <td>one Repository&rsquo;s complete <code>pool/ + dists/</code> tree</td> <td>Workspace <code>sow.yml</code>, <code>.sow/</code>, SQLite, locks, journals, staging</td> </tr> </tbody> </table> </div> <p>For the workspace in <a href="https://sow.pgsty.com/docs/start/workspace/">First Workspace</a>, the source Repository is <code>/srv/sow/local</code>. Do not make <code>/srv/sow</code> the document root.</p> https://sow.pgsty.com/docs/command/publish/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/docs/command/publish/ <p><code>sow publish</code> delivers one Repository&rsquo;s current Built Generation to a named target from the <code>targets:</code> map in <code>sow.yml</code>. The target binds its Repository and provider; the command does not accept <code>--repo</code> or <code>--dist</code>.</p> <h2 id="synopsis">Synopsis </h2> <div class="td-code td-code--untitled" id="td-code-8c0c3742-fence-0" data-td-code data-td-code-auto-id data-td-language="text" data-td-line-count="1"> <div class="td-code__viewport" id="td-code-8c0c3742-fence-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">sow publish TARGET [--abort | --rebind] [-C|--workdir DIR] [-T|--timeout DUR | -N|--no-wait] [--json]</span></span></code></pre></div></div> </div> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">Flag</th> <th scope="col">Meaning</th> <th scope="col">Default</th> </tr> </thead> <tbody> <tr> <td><code>--abort</code></td> <td>Abandon a reconciled attempt that has not reached durable commit intent</td> <td>false</td> </tr> <tr> <td><code>--rebind</code></td> <td>Confirm and record permitted target name/public endpoint/cache-TTL changes</td> <td>false</td> </tr> <tr> <td><code>-C, --workdir DIR</code></td> <td>Workspace discovery start directory</td> <td>current directory</td> </tr> <tr> <td><code>-T, --timeout DUR</code></td> <td>Maximum Repository-lock wait; <code>0</code> waits indefinitely</td> <td><code>0</code></td> </tr> <tr> <td><code>-N, --no-wait</code></td> <td>Fail immediately when the lock is held</td> <td>false</td> </tr> <tr> <td><code>--json</code></td> <td>Emit the <code>sow.cli/v1</code> envelope</td> <td>false</td> </tr> </tbody> </table> </div> <p><code>TARGET</code> must name a configured <code>filesystem</code> or <code>r2</code> publication target. <code>--abort</code> and <code>--rebind</code> are mutually exclusive.</p>