]>
Commit | Line | Data |
---|---|---|
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. | |
5 | daemonize 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. | |
9 | pidfile /var/run/redis.pid | |
10 | ||
ed9b544e | 11 | # Accept connections on the specified port, default is 6379 |
12 | port 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 | 20 | timeout 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 | |
33 | save 900 1 | |
34 | save 300 10 | |
35 | save 60 10000 | |
36 | ||
b8b553c8 | 37 | # The filename where to dump the DB |
38 | dbfilename 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. | |
42 | dir ./ | |
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) | |
49 | loglevel 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 | |
54 | logfile 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 | 59 | databases 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 | ||
142 | appendfsync 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. | |
151 | glueoutputbuf 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 | 167 | shareobjects no |
e52c65b9 | 168 | shareobjectspoolsize 1024 |