]>
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. | |
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 | 137 | appendonly 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 | 155 | appendfsync 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. | |
164 | glueoutputbuf 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 | 180 | shareobjects no |
e52c65b9 | 181 | shareobjectspoolsize 1024 |