1234567891011121314151617181920212223242526272829303132333435363738394041424344454647 |
- .\" generated with Ronn-NG/v0.8.0
- .\" http://github.com/apjanke/ronn-ng/tree/0.8.0
- .TH "REGISTER_NEW_MATRIX_USER" "1" "July 2021" "" ""
- .SH "NAME"
- \fBregister_new_matrix_user\fR \- Used to register new users with a given home server when registration has been disabled
- .SH "SYNOPSIS"
- \fBregister_new_matrix_user\fR options\|\.\|\.\|\.
- .SH "DESCRIPTION"
- \fBregister_new_matrix_user\fR registers new users with a given home server when registration has been disabled\. For this to work, the home server must be configured with the \'registration_shared_secret\' option set\.
- .P
- This accepts the user credentials like the username, password, is user an admin or not and registers the user onto the homeserver database\. Also, a YAML file containing the shared secret can be provided\. If not, the shared secret can be provided via the command line\.
- .P
- By default it assumes the home server URL to be \fBhttps://localhost:8448\fR\. This can be changed via the \fBserver_url\fR command line option\.
- .SH "FILES"
- A sample YAML file accepted by \fBregister_new_matrix_user\fR is described below:
- .IP "" 4
- .nf
- registration_shared_secret: "s3cr3t"
- .fi
- .IP "" 0
- .SH "OPTIONS"
- .TP
- \fB\-u\fR, \fB\-\-user\fR
- Local part of the new user\. Will prompt if omitted\.
- .TP
- \fB\-p\fR, \fB\-\-password\fR
- New password for user\. Will prompt if omitted\. Supplying the password on the command line is not recommended\. Use the STDIN instead\.
- .TP
- \fB\-a\fR, \fB\-\-admin\fR
- Register new user as an admin\. Will prompt if omitted\.
- .TP
- \fB\-c\fR, \fB\-\-config\fR
- Path to server config file containing the shared secret\.
- .TP
- \fB\-k\fR, \fB\-\-shared\-secret\fR
- Shared secret as defined in server config file\. This is an optional parameter as it can be also supplied via the YAML file\.
- .TP
- \fBserver_url\fR
- URL of the home server\. Defaults to \'https://localhost:8448\'\.
- .SH "EXAMPLES"
- .nf
- $ register_new_matrix_user \-u user1 \-p p@ssword \-a \-c config\.yaml
- .fi
- .SH "COPYRIGHT"
- This man page was written by Rahul De <\fI\%mailto:rahulde@swecha\.net\fR> for Debian GNU/Linux distribution\.
- .SH "SEE ALSO"
- synctl(1), synapse_port_db(1), hash_password(1), synapse_review_recent_signups(1)
|