mc admin user add
mc admin user add command adds a new MinIO user to the target MinIO deployment.
To manage external Identity Provider users, see
The following command creates a new user
newuser on the
myminio MinIO deployment:
mc admin user add myminio newuser newusersecret
The command has the following syntax:
mc [GLOBALFLAGS] admin user add \ ALIAS \ ACCESSKEY \ SECRETKEY
indicate optional parameters.
Parameters sharing a line are mutually dependent.
Parameters separated using the pipe
|operator are mutually exclusive.
Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.
aliasof a configured MinIO deployment on which to create the new user.
This command supports any of the global flags.
Create a New User
mc admin user add to create a user on a MinIO deployment:
mc admin user add ALIAS ACCESSKEY SECRETKEY
ACCESSKEYwith the access key for the user.
SECRETKEYwith the secret key for the user. MinIO does not provide any method for retrieving the secret key once set.
Specify a unique, random, and long string for both the
Your organization may have specific internal or regulatory requirements around generating values for use with access or secret keys.
New Users Have No Default Policies
Newly created users have no policies by default and therefore cannot perform any operations on the MinIO deployment. To configure a user’s assigned policies, you can do either or both of the following:
mc admin policy attachto associate one or more policies to the user.
mc admin group addto associate the user to the group. Users inherit any policies assigned to the group.
For more information on MinIO users and groups, see User Management and Group Management. For more information on MinIO policies, see MinIO Policy Based Access Control.
The mc commandline tool is built for compatibility with the AWS S3 API and is tested with MinIO and AWS S3 for expected functionality and behavior.
MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported. While mc commands may work as documented, any such usage is at your own risk.