| 1 | .TH GRID-MANAGER 1 "March 2025" "Tahoe-LAFS" "User Commands" |
|---|
| 2 | . |
|---|
| 3 | .SH NAME |
|---|
| 4 | grid-manager \- A Tahoe Grid Manager for issuing certificates to storage-servers. |
|---|
| 5 | . |
|---|
| 6 | .SH SYNOPSIS |
|---|
| 7 | .B grid-manager |
|---|
| 8 | [\fIOPTIONS\fR] \fICOMMAND\fR [\fIARGS\fR]... |
|---|
| 9 | . |
|---|
| 10 | .SH DESCRIPTION |
|---|
| 11 | A Tahoe Grid Manager issues certificates to storage-servers. |
|---|
| 12 | . |
|---|
| 13 | A Tahoe client with one or more Grid Manager public keys configured will only upload to a Storage Server that presents a valid certificate signed by one of the configured Grid Manager keys. |
|---|
| 14 | . |
|---|
| 15 | Grid Manager configuration can be in a local directory or given via stdin. It contains long-term secret information (a private signing key) and should be kept safe. |
|---|
| 16 | . |
|---|
| 17 | .SH OPTIONS |
|---|
| 18 | .TP |
|---|
| 19 | .BR \f[B]-c,\ --config\ \fIPATH\fR |
|---|
| 20 | Configuration directory (or - for stdin). \fIRequired.\fR |
|---|
| 21 | .TP |
|---|
| 22 | .B \f[B]--help |
|---|
| 23 | Show help message and exit. |
|---|
| 24 | . |
|---|
| 25 | .SH COMMANDS |
|---|
| 26 | .TP |
|---|
| 27 | .B add |
|---|
| 28 | Add a new storage-server by name to a Grid Manager. |
|---|
| 29 | .TP |
|---|
| 30 | .B create |
|---|
| 31 | Make a new Grid Manager. |
|---|
| 32 | .TP |
|---|
| 33 | .B list |
|---|
| 34 | List all storage-servers known to a Grid Manager. |
|---|
| 35 | .TP |
|---|
| 36 | .B public-identity |
|---|
| 37 | Show the public identity key of a Grid Manager. |
|---|
| 38 | .TP |
|---|
| 39 | .B remove |
|---|
| 40 | Remove an existing storage-server by name from a Grid Manager. |
|---|
| 41 | .TP |
|---|
| 42 | .B sign |
|---|
| 43 | Sign a new certificate. |
|---|
| 44 | . |
|---|
| 45 | .SH AUTHORS |
|---|
| 46 | Grid Manager has been written by meejah. |
|---|
| 47 | .PP |
|---|
| 48 | Tahoe-LAFS has been written by Brian Warner, Zooko Wilcox-O'Hearn, and numerous other contributors. |
|---|
| 49 | . |
|---|
| 50 | .SH REPORTING BUGS |
|---|
| 51 | Please see |
|---|
| 52 | .UR https://tahoe-lafs.org/trac/tahoe-lafs/wiki/HowToReportABug |
|---|
| 53 | .UE |
|---|
| 54 | . |
|---|
| 55 | .PP |
|---|
| 56 | Tahoe-LAFS home page: |
|---|
| 57 | .UR https://tahoe-lafs.org/ |
|---|
| 58 | .UE |
|---|
| 59 | .PP |
|---|
| 60 | Tahoe-LAFS development mailing list: |
|---|
| 61 | .UR https://lists.tahoe-lafs.org/mailman/listinfo/tahoe-dev |
|---|
| 62 | .UE |
|---|
| 63 | . |
|---|
| 64 | .SH COPYRIGHT |
|---|
| 65 | Copyright \(co 2006\(en2025 The Tahoe-LAFS Software Foundation. |
|---|
| 66 | . |
|---|
| 67 | .SH SEE ALSO |
|---|
| 68 | .MR tahoe 1 |
|---|
| 69 | .PP |
|---|
| 70 | The Tahoe-LAFS documentation on Grid Managers has more detail than this manual page: |
|---|
| 71 | .UR https://tahoe-lafs.readthedocs.io/en/latest/managed-grid.html |
|---|
| 72 | .UE |
|---|
| 73 | .PP |
|---|
| 74 | It includes a step-by-step tutorial on how to set up a managed grid: |
|---|
| 75 | .UR https://tahoe-lafs.readthedocs.io/en/latest/managed-grid.html#example-setup-of-a-new-managed-grid |
|---|
| 76 | .UE |
|---|
