DIN

Docs

Use DIN as a team, self-hosted

This page is the self-hosted team setup that works today, stated plainly. A self-hosted field is one machine: several people can review the same field, but the field, its records and its agents' capture live on that one machine. Putting several machines' work into one shared field is what the hosted plans are for, and no hosted plan is on sale yet.

Who counts as a person

A person is anyone who stamps a position in the field's review queue, by the name they stamp under. The field counts the different names that have stamped it.

Nothing about a stamp changes with the plan: it carries a name, a date and a reason, and a record whose producer also stamped it is marked self_reviewed on every plan.

One machine runs the field

Pick the machine that holds the record (the "team box") and install DIN there as usual (Install). Its field listens on that machine only: 127.0.0.1:8093 for the first field (din field list shows each field's port). From 1.0.39 it refuses to bind any other address, and it refuses a request addressed to any name other than this machine's, so it cannot be opened to the network by a setting.

The agents whose work you want in the record run on the team box, or capture into it there. An agent on a teammate's own machine captures into that machine's install, which is a separate field.

Teammates review over an SSH tunnel

A teammate reaches the field through an SSH tunnel to the team box, so their browser still talks to 127.0.0.1:

ssh -N -L 8093:127.0.0.1:8093 you@teambox

Then they open http://127.0.0.1:8093/ on their own machine. The page asks once for the field token, which is in .din/field.token under the team box's install (~/din/.din/field.token by default, readable only by its owner). Hand it over by a channel you trust: whoever holds it can read and stamp the whole field. There is no per-person token: everyone who reviews shares this one.

Each person sets the name they stamp under with stamp as on the field's page. Use one name per person, every time: two spellings of one person count as two people.

What is not a launch path