<div id="pagecontent">
<div class="index">
<!-- This is a (PRE) block. Make sure it's left aligned or your toc title will be off. -->
-<b>QuickStart: Contents</b><br>
<a href="#Quick Start">Quick Start</a><br> <a href="#Obtaining the latest version of Redis">Obtaining the latest version of Redis</a><br> <a href="#Compiling Redis">Compiling Redis</a><br> <a href="#Running Redis">Running Redis</a><br> <a href="#Testing Redis">Testing Redis</a><br> <a href="#Further reading">Further reading</a>
+<b>QuickStart: Contents</b><br>
<a href="#Obtain the latest version">Obtain the latest version</a><br> <a href="#Compile">Compile</a><br> <a href="#Run the server">Run the server</a><br> <a href="#Play with the built in client">Play with the built in client</a><br> <a href="#Further reading">Further reading</a>
</div>
<h1 class="wikiname">QuickStart</h1>
</div>
<div class="narrow">
-
<h1><a name="Quick Start">Quick Start</a></h1>This quickstart is a five minutes howto on how to get started with Redis. For more information on Redis check <a href="http://code.google.com/p/redis/wiki/index" target="_blank">Redis Documentation Index</a>.<h2><a name="Obtaining the latest version of Redis">Obtaining the latest version of Redis</a></h2>The latest stable source distribution of Redis can be obtained <a href="http://code.google.com/p/redis/downloads/list" target="_blank">at this location as a tarball</a>. The unstable source code, with more features but not ready for production, can be downloaded using git:<br/><br/><pre class="codeblock python" name="code">
-git clone git://github.com/antirez/redis.git
-</pre>
<h2><a name="Compiling Redis">Compiling Redis</a></h2>Redis can be compiled in most POSIX systems, but the development targets mainly Linux, Mac OS X, FreeBSD and OpenBSD. Solaris is currently not supported and there are no short-term plans to support it.<br/><br/>To compile Redis just untar the tar.gz, enter the directly and type 'make'.<br/><br/><pre class="codeblock python python" name="code">
-tar xvzf redis-1.0.0.tar.gz
-cd redis-1.0.0
-make
-</pre>In order to test if the Redis server is working well in your computer make sure to run <code name="code" class="python">make test</code>and check that all the tests are passed.<h2><a name="Running Redis">Running Redis</a></h2>Redis can run just fine without a configuration file (when executed without a config file a standard configuration is used). To run Redis just type the following command:<br/><br/><pre class="codeblock python python python" name="code">
-./redis-server
-</pre>
With the default configuration Redis will log to the standard output so you can check what happens. Later, when you'll ready to install Redis in production, you may want to use a configuration file. The <code name="code" class="python">redis.conf</code> file included in the source code distribution is a starting point, you should be able to modify it in order do adapt it to your needs without troubles reading the comments inside the file. In order to start Redis using a configuration file just pass the file name as the sole argument when starting the server:<br/><br/><pre class="codeblock python python python python" name="code">
-./redis-server redis.conf
-</pre>
<h2><a name="Testing Redis">Testing Redis</a></h2>To check if the server is working correctly you can use the <code name="code" class="python">redis-cli</code> utility included in the source distribution (and automatically compiled when you compile Redis). For instance to set a key and read back the value use the following:<br/><br/><pre class="codeblock python python python python python" name="code">
-./redis-cli set mykey somevalue
+
= Quick Start =<br/><br/>This quickstart is a five minutes howto on how to get started with Redis. For more information on Redis check <a href="http://code.google.com/p/redis/wiki/index" target="_blank">Redis Documentation Index</a>.<h2><a name="Obtain the latest version">Obtain the latest version</a></h2>The latest stable source distribution of Redis can be obtained <a href="http://code.google.com/p/redis/downloads/list" target="_blank">at this location as a tarball</a>.<br/><br/><pre class="codeblock python" name="code">
+$ wget http://redis.googlecode.com/files/redis-1.02.tar.gz
+</pre>
The unstable source code, with more features but not ready for production, can be downloaded using git:<br/><br/><pre class="codeblock python python" name="code">
+$ git clone git://github.com/antirez/redis.git
+</pre><h2><a name="Compile">Compile</a></h2>Redis can be compiled in most <a href="SupportedPlatforms.html">POSIX systems</a>. To compile Redis just untar the tar.gz, enter the directly and type 'make'.<br/><br/><pre class="codeblock python python python" name="code">
+$ tar xvzf redis-1.02.tar.gz
+$ cd redis-1.02
+$ make
+</pre>
In order to test if the Redis server is working well in your computer make sure to run <code name="code" class="python">make test</code> and check that all the tests are passed.<h2><a name="Run the server">Run the server</a></h2>Redis can run just fine without a configuration file (when executed without a config file a standard configuration is used). To run Redis just type the following command:<br/><br/><pre class="codeblock python python python python" name="code">
+$ ./redis-server
+</pre>
With the <a href="Configuration.html">default configuration</a> Redis will log to the standard output so you can check what happens. Later, you can <a href="Configuration.html">change the default settings</a>.<h2><a name="Play with the built in client">Play with the built in client</a></h2>Redis ships with a command line client that is automatically compiled when you ran <code name="code" class="python">make</code> and it is called <code name="code" class="python">redis-cli</code>For instance to set a key and read back the value use the following:<br/><br/><pre class="codeblock python python python python python" name="code">
+$ ./redis-cli set mykey somevalue
OK
-./redis-cli get mykey
+$ ./redis-cli get mykey
somevalue
-</pre><h2><a name="Further reading">Further reading</a></h2><ul><li> To know more about Redis check the <a href="README.html">Readme</a> file.</li><li> Read the full list of available commands in the <a href="CommandReference.html">Command Reference</a>.</li><li> To get started with the Redis replication read the <a href="ReplicationHowto.html">Replication Howto</a>.</li></ul>
+</pre>What about adding elements to a <a href="Lists.html">list</a>:<br/><br/><pre class="codeblock python python python python python python" name="code">
+$ ./redis-cli lpush mylist firstvalue
+OK
+$ ./redis-cli lpush mylist secondvalue
+OK
+$ ./redis-cli lpush mylist thirdvalue
+OK
+$ ./redis-cli lrange mylist 0 -1
+1. thirdvalue
+2. secondvalue
+3. firstvalue
+$ ./redis-cli rpop mylist
+firstvalue
+$ ./redis-cli lrange mylist 0 -1
+1. thirdvalue
+2. secondvalue
+</pre><h2><a name="Further reading">Further reading</a></h2><ul><li> What to play more with Redis? Read <a href="IntroductionToRedisDataTypes.html">Fifteen minutes introduction to Redis data types</a>.</li><li> Check all the <a href="Features.html">Features</a></li><li> Read the full list of available commands in the <a href="CommandReference.html">Command Reference</a>.</li><li> Start using Redis from your <a href="SupportedLanguages.html">favorite language</a>.</li><li> Take a look at some <a href="ProgrammingExamples.html">Programming Examples</a>. </li></ul>
</div>
</div>
projects / redis.git / blobdiff