Tarantool CE/EE Documentation portal logo
Support
Updated at September 7, 2026   01:25 PM

box.schema.user.create()

box.schema.user.create(name [, {options}])

Create a user. For explanation of how Tarantool maintains user data, see section Users and reference on _user space.

The possible options are:

  • if_not_exists = true|false (default = false) — boolean; true means there should be no error if the user already exists,
  • password (default = '') — string; the password = password specification is good because in a URI (Uniform Resource Identifier) it is usually illegal to include a username without a password.

Parameters:

  • name (string) — a user name, which should conform to the rules for object names
  • options (table) — if_not_exists, password

Returns

nil

Examples:

box.schema.user.create('alice')box.schema.user.create('bob', {password = 'foobar'})

See also: access_control_users.