ref: 9293cb085ab25a71c43dd9ca9404232ff5dd3da6
dir: /man.ht/
<section>
<header>
<h2>Quickstart</h2>
</header>
<p>The public registry is available at:</p>
<p><strong>tcp!registry.9p.zone!6675</strong></p>
<p>Use the following commands for mounting:</p>
<ul>
<li>9front (using <code>srv</code>): <code>srv tcp!registry.9p.zone!6675 registry /mnt/registry</code></li>
<li>9front (using <code>9fs</code>): <code>9fs tcp!registry.9p.zone!6675 /mnt/registry</code></li>
<li>Inferno: <code>mount -A tcp!registry.9p.zone!registry /mnt/registry</code></li>
</ul>
<h3>Add <code>!registry</code> to Plan 9 systems</h3>
<p>To use <code>tcp!registry.9p.zone!registry</code> on Plan 9 systems (like on inferno) add the following line to <code>/lib/ndb/common</code>:</p>
<p><code>tcp=registry port=6675</code></p>
</section>
<section>
<header>
<h2>Add New Services</h2>
</header>
<p>You can post new services to the registry using standard methods. For Inferno systems check out the official documentation, since it's a standard Inferno registry. For Plan 9 systems it is possible by writing strings to the <code>new</code> file, like documented in the Inferno manual.</p>
<p>For Plan 9 systems you can use the following command to post your service:</p>
<p><code>>/mnt/registry/new {echo 'tcp!yourserver!port description ''your description'' contact you@example.com type fileserver'; while(sleep 3600);}</code>. The <code>while</code> loop is used to keep the file descriptor open. When the file descriptor is closed, the service will be removed from the registry.</p>
<p>You can integrate this command in your system or add similar behaviour to your applications.</p>
</section>
<section>
<header>
<h2>Make new account @ 9p.zone EXTRA auth</h2>
</header>
<p><strong>Achtung:</strong> Creating a new account a 9p.zone EXTRA auth will not necessarily grant access to EXTRA services. Sometimes you will need to activate your account at their fileserver.</p>
<p>To create a new account you will need some way to access a 9front machine via rcpu. Drawterm will be enough. Here are the steps:</p>
<ol>
<li>Connect as <code>newuser</code> to the auth server: <code>rcpu -u newuser -h p9auth.9p.zone</code>.</li>
<li>You are presented with a wizard-like process. Follow it.</li>
</ol>
<p>Currently you won't receive automated mails. Still it is best to provide a working mail address so we can reach you if necessary.</p>
<h3>Change your password</h3>
<p>You can change your password using standard routines on every CPU server. For convenience you can <code>rcpu</code> into <code>p9auth.9p.zone</code> and change your password there.</p>
</section>
<section>
<header>
<h2>Unofficial fs+cpu grid (sirjofri)</h2>
</header>
<p>This service can be considered the first EXTRA service on 9p.zone. It is meant to provide some place to work on projects but also share files.</p>
<p>To activate your 9p.zone EXTRA user account at this fileserver you need to connect to its fileserver:</p>
<ol>
<li>Connect as yourself: <code>tlsclient -a tcp!fs.eu.9p.zone!9999</code></li>
<li>You will be asked if you want to activate your account. Answering this with <code>y</code> will activate the account on the server.</li>
<li>After that, you can connect to <em>any</em> cpu server on the grid. All users have their own <code>/usr</code>-directory.</li>
</ol>
<p>The service will be extended with software and other services. Let's see how it develops.</p>
</section>
<section>
<header>
<h2>Promote EXTRA Services</h2>
</header>
<p><strong>As we are still focusing on the CORE services we currently can't support all EXTRA services!</strong></p>
<p>If you want to host your services under the 9p.zone domain see the following checklist and verify that your project fits the description:</p>
<ul>
<li>Your project is free (non-profit) to use and publicly available.</li>
<li>Your project adds value to the public 9p community.</li>
<li>Your project will exist for a longer period of time.</li>
<li>You are willing to cooperate with us.</li>
</ul>
<p>If all of these points apply to your project, <a href="/legal/">contact us</a> and we can figure out the details together. If we decide your project doesn't fit 9p.zone don't be discouraged! We try to give you details about our decision. It's very likely that we like your project and want to support you by other means.</p>
</section>