https://uniforgeai.github.io/claustro/reference/Recent content in Reference on claustroHugoenhttps://uniforgeai.github.io/claustro/reference/claustro-yaml/Mon, 01 Jan 0001 00:00:00 +0000https://uniforgeai.github.io/claustro/reference/claustro-yaml/<h1 id="claustroyaml-reference">claustro.yaml Reference<a class="anchor" href="#claustroyaml-reference">#</a></h1> <p>Complete reference for the claustro configuration file.</p> <h2 id="top-level-fields">Top-level fields<a class="anchor" href="#top-level-fields">#</a></h2> <table> <thead> <tr> <th>Field</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>project</code></td> <td>string</td> <td>Project name (default: directory basename)</td> </tr> <tr> <td><code>image</code></td> <td>string or mapping</td> <td>Custom image name, or image build config</td> </tr> <tr> <td><code>defaults</code></td> <td>mapping</td> <td>Default settings for all sandboxes</td> </tr> <tr> <td><code>sandboxes</code></td> <td>mapping</td> <td>Named sandbox definitions</td> </tr> <tr> <td><code>firewall</code></td> <td>mapping</td> <td>Egress firewall configuration</td> </tr> <tr> <td><code>mcp</code></td> <td>mapping</td> <td>MCP server configuration</td> </tr> <tr> <td><code>git</code></td> <td>mapping</td> <td>Git integration settings</td> </tr> </tbody> </table> <h2 id="image">image<a class="anchor" href="#image">#</a></h2> <p>When a string, uses that image directly. When a mapping, configures the built image.</p>https://uniforgeai.github.io/claustro/reference/environment-variables/Mon, 01 Jan 0001 00:00:00 +0000https://uniforgeai.github.io/claustro/reference/environment-variables/<h1 id="environment-variables">Environment Variables<a class="anchor" href="#environment-variables">#</a></h1> <h2 id="host-environment">Host environment<a class="anchor" href="#host-environment">#</a></h2> <table> <thead> <tr> <th>Variable</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>ANTHROPIC_API_KEY</code></td> <td>Forwarded to sandbox for Claude Code auth</td> </tr> <tr> <td><code>DOCKER_HOST</code></td> <td>Docker daemon connection (if non-default)</td> </tr> </tbody> </table> <h2 id="sandbox-environment">Sandbox environment<a class="anchor" href="#sandbox-environment">#</a></h2> <table> <thead> <tr> <th>Variable</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>HOME</code></td> <td><code>/home/sandbox</code></td> </tr> <tr> <td><code>PATH</code></td> <td>Includes Go, Rust, npm, pip paths</td> </tr> </tbody> </table> <h2 id="custom-variables">Custom variables<a class="anchor" href="#custom-variables">#</a></h2> <p>Pass via CLI:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>claustro up --env DATABASE_URL<span style="color:#f92672">=</span>postgresql://localhost:5432/dev</span></span></code></pre></div><p>Or in <code>claustro.yaml</code>:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#f92672">sandboxes</span>: </span></span><span style="display:flex;"><span> <span style="color:#f92672">api</span>: </span></span><span style="display:flex;"><span> <span style="color:#f92672">env</span>: </span></span><span style="display:flex;"><span> <span style="color:#f92672">DATABASE_URL</span>: <span style="color:#ae81ff">postgresql://localhost:5432/dev</span></span></span></code></pre></div><p>Or via <code>.env</code> file in the project root.</p>