Create new users for the MaxScale REST API using MaxCtrl. This page explains the difference between basic and admin users and provides command examples for adding credentials to your system.
MaxScale has a REST API, which can be configured to require authentication. When first installed, it has a single default admin user (admin) and password (mariadb). However, this user can be deleted, and other users can be created.
MaxCtrl is a command-line utility that can perform administrative tasks using MaxScale's REST API. It can create a user for the REST API.
There are two types of users:
Configure the if the default configuration is not sufficient.
Use MaxCtrl to execute the create user command:
Replace maxscale_rest and maxscale_rest_password with the desired user and password.
Configure the if the default configuration is not sufficient.
Use MaxCtrl to execute the create user command with the --type=admin option:
Replace maxscale_rest_admin and maxscale_rest_admin_password with the desired user and password.
This page is: Copyright © 2025 MariaDB. All rights reserved.
Basic
The user has read-only access
Admin
The user can change global MaxScale parameters and reconfigure modules.
$ maxctrl --secure
--user=admin
--password=mariadb
--hosts=192.0.2.100:8443
--tls-key=/certs/client-key.pem
--tls-cert=/certs/client-cert.pem
--tls-ca-cert=/certs/ca.pem
create user "maxscale_rest" "maxscale_rest_password"$ maxctrl --secure
--user=admin
--password=mariadb
--hosts=192.0.2.100:8443
--tls-key=/certs/client-key.pem
--tls-cert=/certs/client-cert.pem
--tls-ca-cert=/certs/ca.pem
create user "maxscale_rest_admin" "maxscale_rest_admin_password" --type=admin