This article is to help you configure MariaDB for optimal performance.

Note that by default MariaDB is configured to work on a desktop system and should because of this not take a lot of resources. To get things to work for a dedicated server, you have to do a few minutes of work.

For this article we assume that you are going to run MariaDB on a dedicated server.

Note that this article is not yet complete. Please update this if you have more ideas!

my.cnf files

MariaDB is normally configured by editing the my.cnf file.

The following my.cnf example files are included with MariaDB. Examine them to see more complete examples of some of the many ways to configure MariaDB and use the one that fits you best as a base.

  • my-small.cnf
  • my-medium.cnf
  • my-large.cnf
  • my-huge.cnf

Note that these files are now quite outdated, so what was huge a few years ago may no longer be seen as such.

InnoDB & XtraDB storage engine

InnoDB or XtraDB is normally the default storage engine with MariaDB.

  • You should set innodb_buffer_pool_size to about 80% of your memory. The goal is to ensure that 80 % of your working set is in memory!

Aria Storage engine

  • MariaDB uses by default the Aria storage engine for internal temporary files, instead of MyISAM as MySQL does. If you have a lot of temporary files, you should add and set aria_pagecache_buffer_size to a reasonably large value so that temporary overflow data is not flushed to disk. The default is 128M


  • If you don't use MyISAM tables explicitly, you can set key_buffer_size to a very low value, like 64K.

Lots of connections

A lot of fast connections + small set of queries + disconnects

  • If you are doing a lot of fast connections / disconnects, you should increase back_log and thread_cache_size.
  • If you have a lot (> 128) of simultaneous running fast queries, you should consider setting thread_handling to pool_of_threads.

Connecting from a lot of different machines

  • If you are connecting from a lot of different machines you should increase host_cache_size to the max number of machines (default 128) to cache the resolving of hostnames. If you don't connect from a lot of machines, you can set this to a very low value!

See also


Comments loading...