]> git.saurik.com Git - redis.git/blame - redis.conf
appendfsync is now set to NO by default
[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.
67
68# slaveof <masterip> <masterport>
69
f2aa84bd 70################################## SECURITY ###################################
71
72# Require clients to issue AUTH <PASSWORD> before processing any other
73# commands. This might be useful in environments in which you do not trust
74# others with access to the host running redis-server.
75#
76# This should stay commented out for backward compatibility and because most
77# people do not need auth (e.g. they run their own servers).
78
290deb8b 79# requirepass foobared
f2aa84bd 80
285add55 81################################### LIMITS ####################################
82
83# Set the max number of connected clients at the same time. By default there
84# is no limit, and it's up to the number of file descriptors the Redis process
85# is able to open. The special value '0' means no limts.
86# Once the limit is reached Redis will close all the new connections sending
87# an error 'max number of clients reached'.
88
89# maxclients 128
90
3fd78bcd 91# Don't use more memory than the specified amount of bytes.
92# When the memory limit is reached Redis will try to remove keys with an
93# EXPIRE set. It will try to start freeing keys that are going to expire
94# in little time and preserve keys with a longer time to live.
95# Redis will also try to remove objects from free lists if possible.
96#
97# If all this fails, Redis will start to reply with errors to commands
98# that will use more memory, like SET, LPUSH, and so on, and will continue
99# to reply to most read-only commands like GET.
144d479b 100#
101# WARNING: maxmemory can be a good idea mainly if you want to use Redis as a
102# 'state' server or cache, not as a real DB. When Redis is used as a real
103# database the memory usage will grow over the weeks, it will be obvious if
104# it is going to use too much memory in the long run, and you'll have the time
105# to upgrade. With maxmemory after the limit is reached you'll start to get
106# errors for write operations, and this may even lead to DB inconsistency.
3fd78bcd 107
108# maxmemory <bytes>
109
44b38ef4 110############################## APPEND ONLY MODE ###############################
111
112# By default Redis asynchronously dumps the dataset on disk. If you can live
113# with the idea that the latest records will be lost if something like a crash
114# happens this is the preferred way to run Redis. If instead you care a lot
115# about your data and don't want to that a single record can get lost you should
116# enable the append only mode: when this mode is enabled Redis will append
117# every write operation received in the file appendonly.log. This file will
118# be read on startup in order to rebuild the full dataset in memory.
119#
120# Note that you can have both the async dumps and the append only file if you
121# like (you have to comment the "save" statements above to disable the dumps).
122# Still if append only mode is enabled Redis will load the data from the
123# log file at startup ignoring the dump.rdb file.
0154acdc 124#
125# The name of the append only file is "appendonly.log"
44b38ef4 126
127# appendonly yes
128
48f0308a 129# The fsync() calls tells the Operating System to actually write data on disk
130# instead to wait for more data in the output buffer. Some OS will really flush
131# data on disk, some other OS will just try to do it ASAP.
132#
133# Redis supports three different modes:
134#
135# no: don't fsync, just let the OS flush the data when it wants. Faster.
136# always: fsync after every write to the append only log . Slow, Safest.
137# everysec: fsync only if one second passed since the last fsync. Compromise.
138#
139# The default is "no" since it's faster and anyway safer than snapshots from
140# the point of view of durability of the latest records modified.
141
142appendfsync no
143# appendfsync always
144# appendfsync everysec
145
ed9b544e 146############################### ADVANCED CONFIG ###############################
147
148# Glue small output buffers together in order to send small replies in a
149# single TCP packet. Uses a bit more CPU but most of the times it is a win
150# in terms of number of queries per second. Use 'yes' if unsure.
151glueoutputbuf yes
10c43610 152
153# Use object sharing. Can save a lot of memory if you have many common
154# string in your dataset, but performs lookups against the shared objects
155# pool so it uses more CPU and can be a bit slower. Usually it's a good
156# idea.
e52c65b9 157#
158# When object sharing is enabled (shareobjects yes) you can use
159# shareobjectspoolsize to control the size of the pool used in order to try
160# object sharing. A bigger pool size will lead to better sharing capabilities.
161# In general you want this value to be at least the double of the number of
162# very common strings you have in your dataset.
163#
164# WARNING: object sharing is experimental, don't enable this feature
165# in production before of Redis 1.0-stable. Still please try this feature in
166# your development environment so that we can test it better.
10c43610 167shareobjects no
e52c65b9 168shareobjectspoolsize 1024