Memurai Configuration
发布时间:2026-10-15 | 浏览:1
Memurai for Windows is compatible with the Redis®️* API version 7. This includes compatibility with the Redis 7 and Valkey 7 configuration file syntax, with a few differences as described below. Sample, self-documented configuration files can be found here:
Memurai 4 compatible: Valkey 7 configuration
Memurai 4 compatible: Redis 7 configuration
Memurai 3 compatible: Redis 6 configuration
The configuration file is a text file that contains one keyword per line followed by one or multiple values:
Values can contain spaces if they are enclosed in double or single quotes:
Since Memurai maintains compatibility with Redis and Valkey, values that represent a file or folder path can use either backslash \ or forward-slash / :
A common way to run Memurai is as a Windows service using a configuration file, but Memurai can also be executed as a standalone application with or without a configuration file. When running Memurai without a configuration file, a default built-in configuration is used. To start the server without a configuration file, run:
Note: memurai.exe doesn't have write access to its installation folder (e.g. C:\Program Files\Memurai\ ) unless it is executed with administrator privileges, so it is recommended to launch the application from a working directory where the current user has read-write access. Read-write access to the working directory is needed when data persistence is enabled or to persist changes to the configuration file.
Note: when running Memurai as a standalone application, by default it uses the same port number 6379 that is used by the Memurai instance that runs as a Windows service (unless the default Windows service port number was changed or the Memurai Windows service install option was not chosen). Therefore, make sure to run memurai.exe passing a different port number or stop the Memurai Windows service instance if it's running.
To start Memurai with a custom configuration file, you can copy the provided default configuration file from the Memurai installation folder to a folder where the current user has read-write access, and make the desired changes there. To start the server, run:
Memurai also supports passing configuration arguments from the command line. All the configuration settings available in the configuration file can be passed as command line arguments by simply prefixing the corresponding keywords with a double dash -- .
For example, to overwrite the default port and logfile settings without passing a configuration file:
If a configuration file is specified, it must be the first command line argument. Any additional arguments will override the corresponding settings in the configuration file. Example:
Configuration files can be nested using the include keyword. If a flag is present in multiple files, the value in the included configuration file will override the value in the including configuration file.
Multiple instances of Memurai can be run at the same time, as long as they use different port numbers, log files and data files.
Changing configuration flags at runtime
Using the Memurai client memurai-cli.exe , it's possible to change most configuration flags. The rules are the same as in Redis 7 .
Differences with Redis & Valkey configuration flags
Unsupported configuration flags
Memurai supports all the flags, with the exception of these:
always-show-logo
active-defrag-ignore-bytes
active-defrag-threshold-lower
active-defrag-threshold-upper
active-defrag-cycle-min
active-defrag-cycle-max
syslog-facility
If any of these flags are present in a configuration file, they are simply ignored.
Memurai-specific configuration flags
The following configuration flags are Memurai-specific:
Specifies a name for the server instance. This is useful for distinguishing between multiple Memurai instances in the logs. If not empty, the value of instance-name is displayed at the beginning of every Windows Event Log message, and also in one of the first lines of the log file.
Specifies the verbosity level for the Windows Event Log. This flag does not impact the log file output. It is specific to the Event Log only. This can be one of:
debug (a lot of information, useful for development/testing)
verbose (many rarely useful info, but not a mess like the debug level)
notice (moderately verbose, what you want in production probably)
warning (only very important / critical messages are logged)
off (no messages are logged)
Default configuration
If Memurai is started without a configuration file, it will assume default values for the flags it doesn't receive through the command-line. Here's a list of those values in config file format: