TartanStand up your org
Docs · the command line

Your whole network, from the command line.

Everything the console does, the CLI does. It’s what your AI drives, and it’s yours too.

tartanacme.tartan.net
> tartan signup --new-org acme --org-name "Acme IT"
Creating your Tartan passkey: Windows asks for your PIN or fingerprint.
Creating your passkeyPIN or fingerprint
{"ok":true,"result":{…}}
# acme.tartan.net is yours, and you’re its first Owner.
> tartan org show --org acme
{"ok":true,"result":{…}}
>
From zero

A whole org in five commands.

  1. Stand up your org.

    Its name, its own IPv6 space, you as its Owner.

    > tartan signup --new-org acme --org-name "Acme IT"
    acme.tartan.net
  2. Make a join code.

    Hand it out as a code, a QR or a link.

    > tartan code create --org acme --kind device --zone user
    one-use code
  3. Let a device in.

    Your passkey approves it.

    > tartan device approve --org acme --device front-desk
    front-desk · on
  4. Give it a name.

    Reach it by name, not by address.

    > tartan name set --org acme --label files --target device:files-01 --state internal
    files.acme.tartan.net
  5. Share one thing.

    One partner org, one port, an end date.

    > tartan grant offer --org acme --grantee northgate --devices app-01 --grantee_groups staff --ports 443/tcp --ttl 14d
    443/tcp · 14 days
Every write

Every change waits for your passkey.

> tartan device approve --org acme --device front-desk
→
Approve front-desk in acme.tartan.net PIN or fingerprint
→
Audit log
device approvefront-desk
you · from your admin laptop · just now
For scripts and AIs

Made to be driven.

tartan help --json

Every command, described for people and for AIs.

--dry-run

Shows the change before it happens.

{"ok":false,"code":"refused"}

Plain answers in JSON, and fixed exit codes.

The guide

Every task, step by step.

InstallGuide coming
Stand upGuide coming
DevicesGuide coming
NamesGuide coming
FirewallGuide coming
SharingGuide coming
Tech accessGuide coming
AuditGuide coming

Get the CLI.

Signed builds, from Tartan’s GitHub releases. Your AI installs it the same way.

Latest release on GitHub →