Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 487 lines (424 sloc) 20.81 kb
ed9b544 Salvatore Sanfilippo first commit
antirez authored
1 # Redis configuration file example
2
7232400 Salvatore Sanfilippo new units for bytes specification
antirez authored
3 # Note on units: when memory size is needed, it is possible to specifiy
4 # it in the usual form of 1k 5GB 4M and so forth:
5 #
6 # 1k => 1000 bytes
7 # 1kb => 1024 bytes
8 # 1m => 1000000 bytes
9 # 1mb => 1024*1024 bytes
10 # 1g => 1000000000 bytes
11 # 1gb => 1024*1024*1024 bytes
12 #
13 # units are case insensitive so 1GB 1Gb 1gB are all the same.
14
ed9b544 Salvatore Sanfilippo first commit
antirez authored
15 # By default Redis does not run as a daemon. Use 'yes' if you need it.
16 # Note that Redis will write a pid file in /var/run/redis.pid when daemonized.
17 daemonize no
18
029245f Salvatore Sanfilippo clarified a few messages in redis.conf
antirez authored
19 # When running daemonized, Redis writes a pid file in /var/run/redis.pid by
20 # default. You can specify a custom pid file location here.
ed329fc Luc Heinrich Allow to specify the pid file from the config file.
lucsky authored
21 pidfile /var/run/redis.pid
22
a5639e7 Pieter Noordhuis Change initialization to allow listening on both a port and socket
pietern authored
23 # Accept connections on the specified port, default is 6379.
a36d524 Salvatore Sanfilippo If port zero is specified, Redis will not listen for TCP connections
antirez authored
24 # If port 0 is specified Redis will not listen on a TCP socket.
ed9b544 Salvatore Sanfilippo first commit
antirez authored
25 port 6379
26
27 # If you want you can bind a single interface, if the bind option is not
029245f Salvatore Sanfilippo clarified a few messages in redis.conf
antirez authored
28 # specified all the interfaces will listen for incoming connections.
ed9b544 Salvatore Sanfilippo first commit
antirez authored
29 #
30 # bind 127.0.0.1
31
5d10923 Pieter Noordhuis Rename variable sockpath to unixsocket
pietern authored
32 # Specify the path for the unix socket that will be used to listen for
33 # incoming connections. There is no default, so Redis will not listen
34 # on a unix socket when not specified.
a5639e7 Pieter Noordhuis Change initialization to allow listening on both a port and socket
pietern authored
35 #
5d10923 Pieter Noordhuis Rename variable sockpath to unixsocket
pietern authored
36 # unixsocket /tmp/redis.sock
09cefcf Nathan Florea Added a config directive for a Unix socket mask
florean authored
37 # unixsocketperm 755
a5639e7 Pieter Noordhuis Change initialization to allow listening on both a port and socket
pietern authored
38
0150db3 Aman Gupta Allow timeout=0 config to disable client timeouts
tmm1 authored
39 # Close the connection after a client is idle for N seconds (0 to disable)
ed9b544 Salvatore Sanfilippo first commit
antirez authored
40 timeout 300
41
121f70c Salvatore Sanfilippo lzf compression switched off by default now, with config file option to ...
antirez authored
42 # Set server verbosity to 'debug'
43 # it can be one of:
44 # debug (a lot of information, useful for development/testing)
38aba9a Salvatore Sanfilippo a new default redis.conf
antirez authored
45 # verbose (many rarely useful info, but not a mess like the debug level)
121f70c Salvatore Sanfilippo lzf compression switched off by default now, with config file option to ...
antirez authored
46 # notice (moderately verbose, what you want in production probably)
47 # warning (only very important / critical messages are logged)
38aba9a Salvatore Sanfilippo a new default redis.conf
antirez authored
48 loglevel verbose
121f70c Salvatore Sanfilippo lzf compression switched off by default now, with config file option to ...
antirez authored
49
50 # Specify the log file name. Also 'stdout' can be used to force
029245f Salvatore Sanfilippo clarified a few messages in redis.conf
antirez authored
51 # Redis to log on the standard output. Note that if you use standard
121f70c Salvatore Sanfilippo lzf compression switched off by default now, with config file option to ...
antirez authored
52 # output for logging but daemonize, logs will be sent to /dev/null
53 logfile stdout
54
e1a586e Jonah H. Harris syslog support
jonahharris authored
55 # To enable logging to the system logger, just set 'syslog-enabled' to yes,
56 # and optionally update the other syslog parameters to suit your needs.
57 # syslog-enabled no
58
59 # Specify the syslog identity.
60 # syslog-ident redis
61
62 # Specify the syslog facility. Must be USER or between LOCAL0-LOCAL7.
63 # syslog-facility local0
64
121f70c Salvatore Sanfilippo lzf compression switched off by default now, with config file option to ...
antirez authored
65 # Set the number of databases. The default database is DB 0, you can select
66 # a different one on a per-connection basis using SELECT <dbid> where
67 # dbid is a number between 0 and 'databases'-1
68 databases 16
69
70 ################################ SNAPSHOTTING #################################
71 #
ed9b544 Salvatore Sanfilippo first commit
antirez authored
72 # Save the DB on disk:
73 #
74 # save <seconds> <changes>
75 #
76 # Will save the DB if both the given number of seconds and the given
77 # number of write operations against the DB occurred.
78 #
79 # In the example below the behaviour will be to save:
80 # after 900 sec (15 min) if at least 1 key changed
81 # after 300 sec (5 min) if at least 10 keys changed
82 # after 60 sec if at least 10000 keys changed
e7546c6 Salvatore Sanfilippo BGREWRITEAOF now works with swapping on
antirez authored
83 #
84 # Note: you can disable saving at all commenting all the "save" lines.
85
38aba9a Salvatore Sanfilippo a new default redis.conf
antirez authored
86 save 900 1
87 save 300 10
88 save 60 10000
ed9b544 Salvatore Sanfilippo first commit
antirez authored
89
121f70c Salvatore Sanfilippo lzf compression switched off by default now, with config file option to ...
antirez authored
90 # Compress string objects using LZF when dump .rdb databases?
b055378 Salvatore Sanfilippo LZF compression re-enabled by default, but with INIT_HTAB set to 0 to av...
antirez authored
91 # For default that's set to 'yes' as it's almost always a win.
92 # If you want to save some CPU in the saving child set it to 'no' but
93 # the dataset will likely be bigger if you have compressible values or keys.
94 rdbcompression yes
121f70c Salvatore Sanfilippo lzf compression switched off by default now, with config file option to ...
antirez authored
95
b8b553c Salvatore Sanfilippo ability to specify a different file name for the DB
antirez authored
96 # The filename where to dump the DB
97 dbfilename dump.rdb
98
029245f Salvatore Sanfilippo clarified a few messages in redis.conf
antirez authored
99 # The working directory.
100 #
101 # The DB will be written inside this directory, with the filename specified
102 # above using the 'dbfilename' configuration directive.
103 #
104 # Also the Append Only File will be created inside this directory.
105 #
106 # Note that you must specify a directory here, not a file name.
ed9b544 Salvatore Sanfilippo first commit
antirez authored
107 dir ./
108
109 ################################# REPLICATION #################################
110
111 # Master-Slave replication. Use slaveof to make a Redis instance a copy of
112 # another Redis server. Note that the configuration is local to the slave
113 # so for example it is possible to configure the slave to save the DB with a
114 # different interval, or to listen to another port, and so on.
3f47797 Salvatore Sanfilippo TODO list modified. What's planned for 1.4 is now written in the stone ;...
antirez authored
115 #
ed9b544 Salvatore Sanfilippo first commit
antirez authored
116 # slaveof <masterip> <masterport>
117
3f47797 Salvatore Sanfilippo TODO list modified. What's planned for 1.4 is now written in the stone ;...
antirez authored
118 # If the master is password protected (using the "requirepass" configuration
119 # directive below) it is possible to tell the slave to authenticate before
120 # starting the replication synchronization process, otherwise the master will
121 # refuse the slave request.
122 #
123 # masterauth <master-password>
124
4ebfc45 Salvatore Sanfilippo config option to select if when replication link with master a slave sho...
antirez authored
125 # When a slave lost the connection with the master, or when the replication
126 # is still in progress, the slave can act in two different ways:
127 #
128 # 1) if slave-serve-stale-data is set to 'yes' (the default) the slave will
129 # still reply to client requests, possibly with out of data data, or the
130 # data set may just be empty if this is the first synchronization.
131 #
132 # 2) if slave-serve-stale data is set to 'no' the slave will reply with
133 # an error "SYNC with master in progress" to all the kind of commands
134 # but to INFO and SLAVEOF.
135 #
136 slave-serve-stale-data yes
137
7c6da73 Added repl_ping_slave_period and repl_timeout options support
Herbert G. Fischer authored
138 # Slaves send PINGs to server in a predefined interval. It's possible to change
139 # this interval with the repl_ping_slave_period option. The default value is 10
140 # seconds.
141 #
421f6af fixed typo in comments
Herbert G. Fischer authored
142 # repl-ping-slave-period 10
7c6da73 Added repl_ping_slave_period and repl_timeout options support
Herbert G. Fischer authored
143
144 # The following option sets a timeout for both Bulk transfer I/O timeout and
145 # master data or ping response timeout. The default value is 60 seconds.
146 #
9e68987 Salvatore Sanfilippo added more clarifications in redis.conf about ther right value to set as...
antirez authored
147 # It is important to make sure that this value is greater than the value
148 # specified for repl-ping-slave-period otherwise a timeout will be detected
149 # every time there is low traffic between the master and the slave.
150 #
421f6af fixed typo in comments
Herbert G. Fischer authored
151 # repl-timeout 60
7c6da73 Added repl_ping_slave_period and repl_timeout options support
Herbert G. Fischer authored
152
f2aa84b Salvatore Sanfilippo Lua client added thanks to Daniele Alessandri
antirez authored
153 ################################## SECURITY ###################################
154
155 # Require clients to issue AUTH <PASSWORD> before processing any other
156 # commands. This might be useful in environments in which you do not trust
157 # others with access to the host running redis-server.
158 #
159 # This should stay commented out for backward compatibility and because most
160 # people do not need auth (e.g. they run their own servers).
1b67773 Salvatore Sanfilippo CONFIG now can change appendfsync policy at run time
antirez authored
161 #
162 # Warning: since Redis is pretty fast an outside user can try up to
163 # 150k passwords per second against a good box. This means that you should
164 # use a very strong password otherwise it will be very easy to break.
3f47797 Salvatore Sanfilippo TODO list modified. What's planned for 1.4 is now written in the stone ;...
antirez authored
165 #
290deb8 Salvatore Sanfilippo TODO changes, minor change to default redis.conf
antirez authored
166 # requirepass foobared
f2aa84b Salvatore Sanfilippo Lua client added thanks to Daniele Alessandri
antirez authored
167
8d3e063 Salvatore Sanfilippo added support for command renaming/suppression in redis.conf
antirez authored
168 # Command renaming.
169 #
170 # It is possilbe to change the name of dangerous commands in a shared
171 # environment. For instance the CONFIG command may be renamed into something
172 # of hard to guess so that it will be still available for internal-use
173 # tools but not available for general clients.
174 #
175 # Example:
176 #
177 # rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52
178 #
179 # It is also possilbe to completely kill a command renaming it into
180 # an empty string:
181 #
182 # rename-command CONFIG ""
183
285add5 Salvatore Sanfilippo maxclients implemented, see redis.conf for details
antirez authored
184 ################################### LIMITS ####################################
185
186 # Set the max number of connected clients at the same time. By default there
187 # is no limit, and it's up to the number of file descriptors the Redis process
92f8e88 Salvatore Sanfilippo non-blocking VM data structures, just a start
antirez authored
188 # is able to open. The special value '0' means no limits.
285add5 Salvatore Sanfilippo maxclients implemented, see redis.conf for details
antirez authored
189 # Once the limit is reached Redis will close all the new connections sending
190 # an error 'max number of clients reached'.
3f47797 Salvatore Sanfilippo TODO list modified. What's planned for 1.4 is now written in the stone ;...
antirez authored
191 #
285add5 Salvatore Sanfilippo maxclients implemented, see redis.conf for details
antirez authored
192 # maxclients 128
193
3fd78bc Salvatore Sanfilippo maxmemory implemented
antirez authored
194 # Don't use more memory than the specified amount of bytes.
195 # When the memory limit is reached Redis will try to remove keys with an
196 # EXPIRE set. It will try to start freeing keys that are going to expire
197 # in little time and preserve keys with a longer time to live.
198 # Redis will also try to remove objects from free lists if possible.
199 #
200 # If all this fails, Redis will start to reply with errors to commands
201 # that will use more memory, like SET, LPUSH, and so on, and will continue
202 # to reply to most read-only commands like GET.
144d479 Salvatore Sanfilippo minor fix for Solaris boxes
antirez authored
203 #
204 # WARNING: maxmemory can be a good idea mainly if you want to use Redis as a
205 # 'state' server or cache, not as a real DB. When Redis is used as a real
206 # database the memory usage will grow over the weeks, it will be obvious if
207 # it is going to use too much memory in the long run, and you'll have the time
208 # to upgrade. With maxmemory after the limit is reached you'll start to get
209 # errors for write operations, and this may even lead to DB inconsistency.
3f47797 Salvatore Sanfilippo TODO list modified. What's planned for 1.4 is now written in the stone ;...
antirez authored
210 #
3fd78bc Salvatore Sanfilippo maxmemory implemented
antirez authored
211 # maxmemory <bytes>
212
165346c Salvatore Sanfilippo implemented different algorithms for maxmemory
antirez authored
213 # MAXMEMORY POLICY: how Redis will select what to remove when maxmemory
214 # is reached? You can select among five behavior:
215 #
216 # volatile-lru -> remove the key with an expire set using an LRU algorithm
217 # allkeys-lru -> remove any key accordingly to the LRU algorithm
218 # volatile-random -> remove a random key with an expire set
219 # allkeys->random -> remove a random key, any key
220 # volatile-ttl -> remove the key with the nearest expire time (minor TTL)
5402c42 Salvatore Sanfilippo added noeviction policy to redis maxmemory. ZSCORE removed from the list...
antirez authored
221 # noeviction -> don't expire at all, just return an error on write operations
222 #
223 # Note: with all the kind of policies, Redis will return an error on write
224 # operations, when there are not suitable keys for eviction.
225 #
226 # At the date of writing this commands are: set setnx setex append
227 # incr decr rpush lpush rpushx lpushx linsert lset rpoplpush sadd
228 # sinter sinterstore sunion sunionstore sdiff sdiffstore zadd zincrby
229 # zunionstore zinterstore hset hsetnx hmset hincrby incrby decrby
230 # getset mset msetnx exec sort
231 #
232 # The default is:
165346c Salvatore Sanfilippo implemented different algorithms for maxmemory
antirez authored
233 #
234 # maxmemory-policy volatile-lru
235
236 # LRU and minimal TTL algorithms are not precise algorithms but approximated
237 # algorithms (in order to save memory), so you can select as well the sample
238 # size to check. For instance for default Redis will check three keys and
239 # pick the one that was used less recently, you can change the sample size
240 # using the following configuration directive.
241 #
a368792 Salvatore Sanfilippo maxmemory-samples implemented in CONFIG command and configuration file
antirez authored
242 # maxmemory-samples 3
165346c Salvatore Sanfilippo implemented different algorithms for maxmemory
antirez authored
243
44b38ef Salvatore Sanfilippo Initial implementation of append-only mode. Loading still not implemente...
antirez authored
244 ############################## APPEND ONLY MODE ###############################
245
246 # By default Redis asynchronously dumps the dataset on disk. If you can live
247 # with the idea that the latest records will be lost if something like a crash
248 # happens this is the preferred way to run Redis. If instead you care a lot
249 # about your data and don't want to that a single record can get lost you should
250 # enable the append only mode: when this mode is enabled Redis will append
4005fef Salvatore Sanfilippo Now PUBLISH commands are replicated to slaves
antirez authored
251 # every write operation received in the file appendonly.aof. This file will
44b38ef Salvatore Sanfilippo Initial implementation of append-only mode. Loading still not implemente...
antirez authored
252 # be read on startup in order to rebuild the full dataset in memory.
253 #
254 # Note that you can have both the async dumps and the append only file if you
255 # like (you have to comment the "save" statements above to disable the dumps).
256 # Still if append only mode is enabled Redis will load the data from the
257 # log file at startup ignoring the dump.rdb file.
0154acd Salvatore Sanfilippo appendfsync is now set to NO by default
antirez authored
258 #
49b99ab Salvatore Sanfilippo Changed the reply of BGSAVE and BGREWRITEAOF from +OK to a more meaningf...
antirez authored
259 # IMPORTANT: Check the BGREWRITEAOF to check how to rewrite the append
260 # log file in background when it gets too big.
44b38ef Salvatore Sanfilippo Initial implementation of append-only mode. Loading still not implemente...
antirez authored
261
4e141d5 Salvatore Sanfilippo append only mode is now able to translate EXPIRE into EXPIREAT transpare...
antirez authored
262 appendonly no
44b38ef Salvatore Sanfilippo Initial implementation of append-only mode. Loading still not implemente...
antirez authored
263
f3b5241 Pieter Noordhuis make append only filename configurable
pietern authored
264 # The name of the append only file (default: "appendonly.aof")
265 # appendfilename appendonly.aof
266
4e141d5 Salvatore Sanfilippo append only mode is now able to translate EXPIRE into EXPIREAT transpare...
antirez authored
267 # The fsync() call tells the Operating System to actually write data on disk
48f0308 Salvatore Sanfilippo support for appendonly mode no, always, everysec
antirez authored
268 # instead to wait for more data in the output buffer. Some OS will really flush
269 # data on disk, some other OS will just try to do it ASAP.
270 #
271 # Redis supports three different modes:
272 #
273 # no: don't fsync, just let the OS flush the data when it wants. Faster.
274 # always: fsync after every write to the append only log . Slow, Safest.
275 # everysec: fsync only if one second passed since the last fsync. Compromise.
276 #
6766f45 Salvatore Sanfilippo multi bulk requests in redis-benchmark, default fsync policy changed to ...
antirez authored
277 # The default is "everysec" that's usually the right compromise between
278 # speed and data safety. It's up to you to understand if you can relax this to
279 # "no" that will will let the operating system flush the output buffer when
280 # it wants, for better performances (but if you can live with the idea of
281 # some data loss consider the default persistence mode that's snapshotting),
282 # or on the contrary, use "always" that's very slow but a bit safer than
283 # everysec.
284 #
285 # If unsure, use "everysec".
286
287 # appendfsync always
288 appendfsync everysec
4e141d5 Salvatore Sanfilippo append only mode is now able to translate EXPIRE into EXPIREAT transpare...
antirez authored
289 # appendfsync no
48f0308 Salvatore Sanfilippo support for appendonly mode no, always, everysec
antirez authored
290
d5d23da Salvatore Sanfilippo redis.conf new features the new option, a minor typo preventing the comp...
antirez authored
291 # When the AOF fsync policy is set to always or everysec, and a background
292 # saving process (a background save or AOF log background rewriting) is
293 # performing a lot of I/O against the disk, in some Linux configurations
294 # Redis may block too long on the fsync() call. Note that there is no fix for
295 # this currently, as even performing fsync in a different thread will block
296 # our synchronous write(2) call.
297 #
298 # In order to mitigate this problem it's possible to use the following option
299 # that will prevent fsync() from being called in the main process while a
300 # BGSAVE or BGREWRITEAOF is in progress.
301 #
302 # This means that while another child is saving the durability of Redis is
303 # the same as "appendfsync none", that in pratical terms means that it is
304 # possible to lost up to 30 seconds of log in the worst scenario (with the
305 # default Linux settings).
306 #
307 # If you have latency problems turn this to "yes". Otherwise leave it as
308 # "no" that is the safest pick from the point of view of durability.
309 no-appendfsync-on-rewrite no
310
61751a4 Salvatore Sanfilippo AOF auto rewrite backported to 2.4
antirez authored
311 # Automatic rewrite of the append only file.
312 # Redis is able to automatically rewrite the log file implicitly calling
313 # BGREWRITEAOF when the AOF log size will growth by the specified percentage.
314 #
315 # This is how it works: Redis remembers the size of the AOF file after the
316 # latest rewrite (or if no rewrite happened since the restart, the size of
317 # the AOF at startup is used).
318 #
319 # This base size is compared to the current size. If the current size is
320 # bigger than the specified percentage, the rewrite is triggered. Also
321 # you need to specify a minimal size for the AOF file to be rewritten, this
322 # is useful to avoid rewriting the AOF file even if the percentage increase
323 # is reached but it is still pretty small.
324 #
325 # Specify a precentage of zero in order to disable the automatic AOF
326 # rewrite feature.
327
328 auto-aof-rewrite-percentage 100
329 auto-aof-rewrite-min-size 64mb
330
99509ab Salvatore Sanfilippo slow log merged into 2.4
antirez authored
331 ################################## SLOW LOG ###################################
332
333 # The Redis Slow Log is a system to log queries that exceeded a specified
334 # execution time. The execution time does not include the I/O operations
335 # like talking with the client, sending the reply and so forth,
336 # but just the time needed to actually execute the command (this is the only
337 # stage of command execution where the thread is blocked and can not serve
338 # other requests in the meantime).
339 #
340 # You can configure the slow log with two parameters: one tells Redis
341 # what is the execution time, in microseconds, to exceed in order for the
342 # command to get logged, and the other parameter is the length of the
343 # slow log. When a new command is logged the oldest one is removed from the
344 # queue of logged commands.
345
346 # The following time is expressed in microseconds, so 1000000 is equivalent
347 # to one second. Note that a negative number disables the slow log, while
348 # a value of zero forces the logging of every command.
349 slowlog-log-slower-than 10000
350
351 # There is no limit to this length. Just be aware that it will consume memory.
352 # You can reclaim memory used by the slow log with SLOWLOG RESET.
847fc09 Salvatore Sanfilippo Fixed typo in redis.conf related to slow log parameters
antirez authored
353 slowlog-max-len 1024
99509ab Salvatore Sanfilippo slow log merged into 2.4
antirez authored
354
a35ddf1 Salvatore Sanfilippo more object-level VM primitives
antirez authored
355 ################################ VIRTUAL MEMORY ###############################
356
7a4c468 Salvatore Sanfilippo Warn the user in redis.conf that VM is deprecated and discouraged
antirez authored
357 ### WARNING! Virtual Memory is deprecated in Redis 2.4
358 ### The use of Virtual Memory is strongly discouraged.
359
4ef8de8 Salvatore Sanfilippo basic VM mostly working!
antirez authored
360 # Virtual Memory allows Redis to work with datasets bigger than the actual
361 # amount of RAM needed to hold the whole dataset in memory.
362 # In order to do so very used keys are taken in memory while the other keys
363 # are swapped into a swap file, similarly to what operating systems do
364 # with memory pages.
365 #
366 # To enable VM just set 'vm-enabled' to yes, and set the following three
367 # VM parameters accordingly to your needs.
c9e5c23 Salvatore Sanfilippo vm-enabled set to no by default in redis.conf
antirez authored
368
369 vm-enabled no
370 # vm-enabled yes
4ef8de8 Salvatore Sanfilippo basic VM mostly working!
antirez authored
371
054e426 Salvatore Sanfilippo support for named VM swap file. Fixed a few important interaction issues...
antirez authored
372 # This is the path of the Redis swap file. As you can guess, swap files
373 # can't be shared by different Redis instances, so make sure to use a swap
a0e7e5f Salvatore Sanfilippo swap file name pid expansion removed. Not suited for mission critical so...
antirez authored
374 # file for every redis process you are running. Redis will complain if the
375 # swap file is already in use.
054e426 Salvatore Sanfilippo support for named VM swap file. Fixed a few important interaction issues...
antirez authored
376 #
a0e7e5f Salvatore Sanfilippo swap file name pid expansion removed. Not suited for mission critical so...
antirez authored
377 # The best kind of storage for the Redis swap file (that's accessed at random)
378 # is a Solid State Disk (SSD).
5921aa3 Salvatore Sanfilippo Bug #169 fixed (BLOP/BRPOP interrupted connections are not cleared from ...
antirez authored
379 #
380 # *** WARNING *** if you are using a shared hosting the default of putting
381 # the swap file under /tmp is not secure. Create a dir with access granted
382 # only to Redis user and configure Redis to create the swap file there.
a0e7e5f Salvatore Sanfilippo swap file name pid expansion removed. Not suited for mission critical so...
antirez authored
383 vm-swap-file /tmp/redis.swap
054e426 Salvatore Sanfilippo support for named VM swap file. Fixed a few important interaction issues...
antirez authored
384
4ef8de8 Salvatore Sanfilippo basic VM mostly working!
antirez authored
385 # vm-max-memory configures the VM to use at max the specified amount of
386 # RAM. Everything that deos not fit will be swapped on disk *if* possible, that
387 # is, if there is still enough contiguous space in the swap file.
38aba9a Salvatore Sanfilippo a new default redis.conf
antirez authored
388 #
ce83302 Salvatore Sanfilippo Saner VM defaults for redis.conf
antirez authored
389 # With vm-max-memory 0 the system will swap everything it can. Not a good
390 # default, just specify the max amount of RAM you can in bytes, but it's
391 # better to leave some margin. For instance specify an amount of RAM
392 # that's more or less between 60 and 80% of your free RAM.
393 vm-max-memory 0
4ef8de8 Salvatore Sanfilippo basic VM mostly working!
antirez authored
394
395 # Redis swap files is split into pages. An object can be saved using multiple
396 # contiguous pages, but pages can't be shared between different objects.
397 # So if your page is too big, small objects swapped out on disk will waste
398 # a lot of space. If you page is too small, there is less space in the swap
399 # file (assuming you configured the same number of total swap file pages).
400 #
401 # If you use a lot of small objects, use a page size of 64 or 32 bytes.
402 # If you use a lot of big objects, use a bigger page size.
92f8e88 Salvatore Sanfilippo non-blocking VM data structures, just a start
antirez authored
403 # If unsure, use the default :)
ce83302 Salvatore Sanfilippo Saner VM defaults for redis.conf
antirez authored
404 vm-page-size 32
4ef8de8 Salvatore Sanfilippo basic VM mostly working!
antirez authored
405
406 # Number of total memory pages in the swap file.
407 # Given that the page table (a bitmap of free/used pages) is taken in memory,
408 # every 8 pages on disk will consume 1 byte of RAM.
409 #
410 # The total swap size is vm-page-size * vm-pages
411 #
ce83302 Salvatore Sanfilippo Saner VM defaults for redis.conf
antirez authored
412 # With the default of 32-bytes memory pages and 134217728 pages Redis will
413 # use a 4 GB swap file, that will use 16 MB of RAM for the page table.
38aba9a Salvatore Sanfilippo a new default redis.conf
antirez authored
414 #
415 # It's better to use the smallest acceptable value for your application,
416 # but the default is large in order to work in most conditions.
ce83302 Salvatore Sanfilippo Saner VM defaults for redis.conf
antirez authored
417 vm-pages 134217728
a35ddf1 Salvatore Sanfilippo more object-level VM primitives
antirez authored
418
92f8e88 Salvatore Sanfilippo non-blocking VM data structures, just a start
antirez authored
419 # Max number of VM I/O threads running at the same time.
420 # This threads are used to read/write data from/to swap file, since they
421 # also encode and decode objects from disk to memory or the reverse, a bigger
422 # number of threads can help with big objects even if they can't help with
423 # I/O itself as the physical device may not be able to couple with many
424 # reads/writes operations at the same time.
72e9fd4 Salvatore Sanfilippo support for blocking VM in config file
antirez authored
425 #
426 # The special value of 0 turn off threaded I/O and enables the blocking
427 # Virtual Memory implementation.
92f8e88 Salvatore Sanfilippo non-blocking VM data structures, just a start
antirez authored
428 vm-max-threads 4
429
ed9b544 Salvatore Sanfilippo first commit
antirez authored
430 ############################### ADVANCED CONFIG ###############################
431
cbba7dd Salvatore Sanfilippo HSET fixes, now the new pointer is stored back in the object pointer fie...
antirez authored
432 # Hashes are encoded in a special way (much more memory efficient) when they
433 # have at max a given numer of elements, and the biggest element does not
434 # exceed a given threshold. You can configure this limits with the following
435 # configuration directives.
99677e8 Salvatore Sanfilippo default hash encoding settings also fixed in redis.conf
antirez authored
436 hash-max-zipmap-entries 512
437 hash-max-zipmap-value 64
b3f83f1 Jeremy Zawodny support for include directive in config parser
jzawodn authored
438
6a246b1 Salvatore Sanfilippo special encoding limits redefined, and all the config options for specia...
antirez authored
439 # Similarly to hashes, small lists are also encoded in a special way in order
440 # to save a lot of space. The special representation is only used when
441 # you are under the following limits:
442 list-max-ziplist-entries 512
443 list-max-ziplist-value 64
444
445 # Sets have a special encoding in just one case: when a set is composed
446 # of just strings that happens to be integers in radix 10 in the range
447 # of 64 bit signed integers.
448 # The following configuration setting sets the limit in the size of the
449 # set in order to use this special memory saving encoding.
450 set-max-intset-entries 512
451
eab8382 Pieter Noordhuis Configurable thresholds for encoded sorted sets
pietern authored
452 # Similarly to hashes and lists, sorted sets are also specially encoded in
453 # order to save a lot of space. This encoding is only used when the length and
454 # elements of a sorted set are below the following limits:
455 zset-max-ziplist-entries 128
456 zset-max-ziplist-value 64
457
8ca3e9d Salvatore Sanfilippo Active rehashing
antirez authored
458 # Active rehashing uses 1 millisecond every 100 milliseconds of CPU time in
459 # order to help rehashing the main Redis hash table (the one mapping top-level
460 # keys to values). The hash table implementation redis uses (see dict.c)
461 # performs a lazy rehashing: the more operation you run into an hash table
462 # that is rhashing, the more rehashing "steps" are performed, so if the
463 # server is idle the rehashing is never complete and some more memory is used
464 # by the hash table.
465 #
466 # The default is to use this millisecond 10 times every second in order to
467 # active rehashing the main dictionaries, freeing memory when possible.
468 #
469 # If unsure:
470 # use "activerehashing no" if you have hard latency requirements and it is
471 # not a good thing in your environment that Redis can reply form time to time
472 # to queries with 2 milliseconds delay.
473 #
474 # use "activerehashing yes" if you don't have such hard requirements but
475 # want to free memory asap when possible.
476 activerehashing yes
477
b3f83f1 Jeremy Zawodny support for include directive in config parser
jzawodn authored
478 ################################## INCLUDES ###################################
479
480 # Include one or more other config files here. This is useful if you
481 # have a standard template that goes to all redis server but also need
482 # to customize a few per-server settings. Include files can include
483 # other files, so use this wisely.
484 #
485 # include /path/to/local.conf
486 # include /path/to/other.conf
Something went wrong with that request. Please try again.