]> git.saurik.com Git - redis.git/blame - redis.conf
Fixed a lame epoll issue
[redis.git] / redis.conf
CommitLineData
ed9b544e 1# Redis configuration file example
2
3# By default Redis does not run as a daemon. Use 'yes' if you need it.
4# Note that Redis will write a pid file in /var/run/redis.pid when daemonized.
5daemonize no
6
ed329fcf
LH
7# When run as a daemon, Redis write a pid file in /var/run/redis.pid by default.
8# You can specify a custom pid file location here.
9pidfile /var/run/redis.pid
10
ed9b544e 11# Accept connections on the specified port, default is 6379
12port 6379
13
14# If you want you can bind a single interface, if the bind option is not
15# specified all the interfaces will listen for connections.
16#
17# bind 127.0.0.1
18
0150db36 19# Close the connection after a client is idle for N seconds (0 to disable)
ed9b544e 20timeout 300
21
22# Save the DB on disk:
23#
24# save <seconds> <changes>
25#
26# Will save the DB if both the given number of seconds and the given
27# number of write operations against the DB occurred.
28#
29# In the example below the behaviour will be to save:
30# after 900 sec (15 min) if at least 1 key changed
31# after 300 sec (5 min) if at least 10 keys changed
32# after 60 sec if at least 10000 keys changed
33save 900 1
34save 300 10
35save 60 10000
36
b8b553c8 37# The filename where to dump the DB
38dbfilename dump.rdb
39
ed9b544e 40# For default save/load DB in/from the working directory
41# Note that you must specify a directory not a file name.
42dir ./
43
44# Set server verbosity to 'debug'
45# it can be one of:
46# debug (a lot of information, useful for development/testing)
47# notice (moderately verbose, what you want in production probably)
48# warning (only very important / critical messages are logged)
49loglevel debug
50
51# Specify the log file name. Also 'stdout' can be used to force
52# the demon to log on the standard output. Note that if you use standard
53# output for logging but daemonize, logs will be sent to /dev/null
54logfile stdout
55
b8b553c8 56# Set the number of databases. The default database is DB 0, you can select
57# a different one on a per-connection basis using SELECT <dbid> where
58# dbid is a number between 0 and 'databases'-1
ed9b544e 59databases 16
60
61################################# REPLICATION #################################
62
63# Master-Slave replication. Use slaveof to make a Redis instance a copy of
64# another Redis server. Note that the configuration is local to the slave
65# so for example it is possible to configure the slave to save the DB with a
66# different interval, or to listen to another port, and so on.
3f477979 67#
ed9b544e 68# slaveof <masterip> <masterport>
69
3f477979 70# If the master is password protected (using the "requirepass" configuration
71# directive below) it is possible to tell the slave to authenticate before
72# starting the replication synchronization process, otherwise the master will
73# refuse the slave request.
74#
75# masterauth <master-password>
76
f2aa84bd 77################################## SECURITY ###################################
78
79# Require clients to issue AUTH <PASSWORD> before processing any other
80# commands. This might be useful in environments in which you do not trust
81# others with access to the host running redis-server.
82#
83# This should stay commented out for backward compatibility and because most
84# people do not need auth (e.g. they run their own servers).
3f477979 85#
290deb8b 86# requirepass foobared
f2aa84bd 87
285add55 88################################### LIMITS ####################################
89
90# Set the max number of connected clients at the same time. By default there
91# is no limit, and it's up to the number of file descriptors the Redis process
92# is able to open. The special value '0' means no limts.
93# Once the limit is reached Redis will close all the new connections sending
94# an error 'max number of clients reached'.
3f477979 95#
285add55 96# maxclients 128
97
3fd78bcd 98# Don't use more memory than the specified amount of bytes.
99# When the memory limit is reached Redis will try to remove keys with an
100# EXPIRE set. It will try to start freeing keys that are going to expire
101# in little time and preserve keys with a longer time to live.
102# Redis will also try to remove objects from free lists if possible.
103#
104# If all this fails, Redis will start to reply with errors to commands
105# that will use more memory, like SET, LPUSH, and so on, and will continue
106# to reply to most read-only commands like GET.
144d479b 107#
108# WARNING: maxmemory can be a good idea mainly if you want to use Redis as a
109# 'state' server or cache, not as a real DB. When Redis is used as a real
110# database the memory usage will grow over the weeks, it will be obvious if
111# it is going to use too much memory in the long run, and you'll have the time
112# to upgrade. With maxmemory after the limit is reached you'll start to get
113# errors for write operations, and this may even lead to DB inconsistency.
3f477979 114#
3fd78bcd 115# maxmemory <bytes>
116
44b38ef4 117############################## APPEND ONLY MODE ###############################
118
119# By default Redis asynchronously dumps the dataset on disk. If you can live
120# with the idea that the latest records will be lost if something like a crash
121# happens this is the preferred way to run Redis. If instead you care a lot
122# about your data and don't want to that a single record can get lost you should
123# enable the append only mode: when this mode is enabled Redis will append
124# every write operation received in the file appendonly.log. This file will
125# be read on startup in order to rebuild the full dataset in memory.
126#
127# Note that you can have both the async dumps and the append only file if you
128# like (you have to comment the "save" statements above to disable the dumps).
129# Still if append only mode is enabled Redis will load the data from the
130# log file at startup ignoring the dump.rdb file.
0154acdc 131#
132# The name of the append only file is "appendonly.log"
49b99ab4 133#
134# IMPORTANT: Check the BGREWRITEAOF to check how to rewrite the append
135# log file in background when it gets too big.
44b38ef4 136
4e141d5a 137appendonly no
44b38ef4 138
4e141d5a 139# The fsync() call tells the Operating System to actually write data on disk
48f0308a 140# instead to wait for more data in the output buffer. Some OS will really flush
141# data on disk, some other OS will just try to do it ASAP.
142#
143# Redis supports three different modes:
144#
145# no: don't fsync, just let the OS flush the data when it wants. Faster.
146# always: fsync after every write to the append only log . Slow, Safest.
147# everysec: fsync only if one second passed since the last fsync. Compromise.
148#
4e141d5a 149# The default is "always" that's the safer of the options. It's up to you to
150# understand if you can relax this to "everysec" that will fsync every second
151# or to "no" that will let the operating system flush the output buffer when
152# it want, for better performances (but if you can live with the idea of
153# some data loss consider the default persistence mode that's snapshotting).
48f0308a 154
4e141d5a 155appendfsync always
48f0308a 156# appendfsync everysec
4e141d5a 157# appendfsync no
48f0308a 158
ed9b544e 159############################### ADVANCED CONFIG ###############################
160
161# Glue small output buffers together in order to send small replies in a
162# single TCP packet. Uses a bit more CPU but most of the times it is a win
163# in terms of number of queries per second. Use 'yes' if unsure.
164glueoutputbuf yes
10c43610 165
166# Use object sharing. Can save a lot of memory if you have many common
167# string in your dataset, but performs lookups against the shared objects
168# pool so it uses more CPU and can be a bit slower. Usually it's a good
169# idea.
e52c65b9 170#
171# When object sharing is enabled (shareobjects yes) you can use
172# shareobjectspoolsize to control the size of the pool used in order to try
173# object sharing. A bigger pool size will lead to better sharing capabilities.
174# In general you want this value to be at least the double of the number of
175# very common strings you have in your dataset.
176#
177# WARNING: object sharing is experimental, don't enable this feature
178# in production before of Redis 1.0-stable. Still please try this feature in
179# your development environment so that we can test it better.
10c43610 180shareobjects no
e52c65b9 181shareobjectspoolsize 1024