Go to file
2010-11-04 19:59:21 +01:00
client-libraries client-libraries directory readded 2009-11-03 12:05:13 +01:00
deps Import linenoise as dependency for redis-cli 2010-11-03 17:15:23 +01:00
design-documents Added more information about slave election in Redis Cluster alternative doc 2010-04-29 15:39:11 +02:00
doc Fix for solaris compilation bug Issue 325 2010-09-06 10:12:44 +02:00
src config option to select if when replication link with master a slave should or not serve stale data 2010-11-04 19:59:21 +01:00
tests minor test suite bug fixed 2010-11-04 10:48:49 +01:00
utils Fix for the init script provided with Redis, thanks to Rowan. This fixes issue 316 2010-09-09 10:24:56 +02:00
.gitignore gitignore modified 2010-07-01 14:41:03 +02:00
BUGS first commit 2009-03-22 10:30:00 +01:00
Changelog Make log target fixed 2010-07-01 14:45:37 +02:00
CONTRIBUTING Contributing file added 2010-09-23 18:24:47 +02:00
COPYING first commit 2009-03-22 10:30:00 +01:00
INSTALL Rename INSTALL_TOP to PREFIX; update documentation 2010-09-13 16:09:11 +01:00
Makefile top level make clean also clean hiredis and linoise (deps) 2010-11-03 18:14:09 +01:00
README README more specific about tcmalloc space benefits 2010-10-22 00:18:26 +02:00
redis.conf config option to select if when replication link with master a slave should or not serve stale data 2010-11-04 19:59:21 +01:00
TODO TODO list modified, trivial change to source code 2010-07-16 23:56:18 +02:00

Where to find complete Redis documentation?
-------------------------------------------

This README is just a fast "quick start" document. You can find more detailed
documentation here:

1) http://code.google.com/p/redis
2) Check the 'doc' directory. doc/README.html is a good starting point :)

Building Redis
--------------

It is as simple as:

    % make

Redis is just a single binary, but if you want to install it you can use
the "make install" target that will copy the binary in /usr/local/bin
for default. You can also use "make PREFIX=/some/other/directory install"
if you wish to use a different destination.

You can run a 32 bit Redis binary using:

    % make 32bit

After you build Redis is a good idea to test it, using:

    % make test

Buliding using tcmalloc
-----------------------

tcmalloc is a fast and space efficient implementation (for little objects)
of malloc(). Compiling Redis with it can improve performances and memeory
usage. You can read more about it here:

http://goog-perftools.sourceforge.net/doc/tcmalloc.html

In order to compile Redis with tcmalloc support install tcmalloc on your system
and then use:

    % make USE_TCMALLOC=yes

Note that you can pass any other target to make, as long as you append
USE_TCMALLOC=yes at the end.

Running Redis
-------------

To run Redis with the default configuration just type:

    % cd src
    % ./redis-server
    
If you want to provide your redis.conf, you have to run it using an additional
parameter (the path of the configuration file):

    % cd src
    % ./redis-server /path/to/redis.conf

Playing with Redis
------------------

You can use redis-cli to play with Redis. Start a redis-server instance,
then in another terminal try the following:

    % cd src
    % ./redis-cli
    redis> ping
    PONG
    redis> set foo bar
    OK
    redis> get foo
    "bar"
    redis> incr mycounter
    (integer) 1
    redis> incr mycounter
    (integer) 2
    redis> 

You can find the list of all the available commands here:

    http://code.google.com/p/redis/wiki/CommandReference

Enjoy!