Skip to content

Commit c8258cf

Browse files
add link and fix a bit of language to address issue #885 (#2629)
* Update _index.md to fix #885 fixes #885 and removes a bit of language for clarity * Update _index.md #885
1 parent 95cb44d commit c8258cf

File tree

1 file changed

+15
-14
lines changed

1 file changed

+15
-14
lines changed

docs/install/install-redis/_index.md

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -23,14 +23,15 @@ How you install Redis depends on your operating system and whether you'd like to
2323
* [Install Redis on Windows](/docs/install/install-redis/install-redis-on-windows)
2424
* [Install Redis with Redis Stack and RedisInsight](/docs/install/install-stack/)
2525

26+
Refer to [Redis Administration](/docs/management/admin/) for detailed setup tips.
2627

2728
## Test if you can connect using the CLI
2829

29-
Once you have Redis up and running, you can connect using `redis-cli`.
30+
After you have Redis up and running, you can connect using `redis-cli`.
3031

31-
External programs talk to Redis using a TCP socket and a Redis specific protocol. This protocol is implemented in the Redis client libraries for the different programming languages. However to make hacking with Redis simpler Redis provides a command line utility that can be used to send commands to Redis. This program is called **redis-cli**.
32+
External programs talk to Redis using a TCP socket and a Redis specific protocol. This protocol is implemented in the Redis client libraries for the different programming languages. However, to make hacking with Redis simpler, Redis provides a command line utility that can be used to send commands to Redis. This program is called **redis-cli**.
3233

33-
The first thing to do in order to check if Redis is working properly is sending a **PING** command using redis-cli:
34+
The first thing to do to check if Redis is working properly is sending a **PING** command using redis-cli:
3435

3536
```
3637
$ redis-cli ping
@@ -49,33 +50,33 @@ PONG
4950

5051
## Securing Redis
5152

52-
By default Redis binds to **all the interfaces** and has no authentication at all. If you use Redis in a very controlled environment, separated from the external internet and in general from attackers, that's fine. However if an unhardened Redis is exposed to the internet, it is a big security concern. If you are not 100% sure your environment is secured properly, please check the following steps in order to make Redis more secure:
53+
By default Redis binds to **all the interfaces** and has no authentication at all. If you use Redis in a very controlled environment, separated from the external internet and in general from attackers, that's fine. However, if an unhardened Redis is exposed to the internet, it is a big security concern. If you are not 100% sure your environment is secured properly, please check the following steps in order to make Redis more secure:
5354

5455
1. Make sure the port Redis uses to listen for connections (by default 6379 and additionally 16379 if you run Redis in cluster mode, plus 26379 for Sentinel) is firewalled, so that it is not possible to contact Redis from the outside world.
55-
2. Use a configuration file where the `bind` directive is set in order to guarantee that Redis listens on only the network interfaces you are using. For example only the loopback interface (127.0.0.1) if you are accessing Redis just locally from the same computer, and so forth.
56-
3. Use the `requirepass` option in order to add an additional layer of security so that clients will require to authenticate using the `AUTH` command.
57-
4. Use [spiped](http://www.tarsnap.com/spiped.html) or another SSL tunneling software in order to encrypt traffic between Redis servers and Redis clients if your environment requires encryption.
56+
2. Use a configuration file where the `bind` directive is set in order to guarantee that Redis listens on only the network interfaces you are using. For example, only the loopback interface (127.0.0.1) if you are accessing Redis locally from the same computer.
57+
3. Use the `requirepass` option to add an additional layer of security so that clients will be required to authenticate using the `AUTH` command.
58+
4. Use [spiped](http://www.tarsnap.com/spiped.html) or another SSL tunneling software to encrypt traffic between Redis servers and Redis clients if your environment requires encryption.
5859

59-
Note that a Redis instance exposed to the internet without any security [is very simple to exploit](http://antirez.com/news/96), so make sure you understand the above and apply **at least** a firewall layer. After the firewall is in place, try to connect with `redis-cli` from an external host in order to prove yourself the instance is actually not reachable.
60+
Note that a Redis instance exposed to the internet without any security [is very simple to exploit](http://antirez.com/news/96), so make sure you understand the above and apply **at least** a firewall layer. After the firewall is in place, try to connect with `redis-cli` from an external host to confirm that the instance is not reachable.
6061

6162
## Use Redis from your application
6263

63-
Of course using Redis just from the command line interface is not enough as the goal is to use it from your application. In order to do so you need to download and install a Redis client library for your programming language.
64+
Of course using Redis just from the command line interface is not enough as the goal is to use it from your application. To do so, you need to download and install a Redis client library for your programming language.
6465

6566
You'll find a [full list of clients for different languages in this page](/clients).
6667

6768

6869
## Redis persistence
6970

70-
You can learn [how Redis persistence works on this page](/docs/management/persistence/), however what is important to understand for a quick start is that by default, if you start Redis with the default configuration, Redis will spontaneously save the dataset only from time to time (for instance after at least five minutes if you have at least 100 changes in your data), so if you want your database to persist and be reloaded after a restart make sure to call the **SAVE** command manually every time you want to force a data set snapshot. Otherwise make sure to shutdown the database using the **SHUTDOWN** command:
71+
You can learn [how Redis persistence works on this page](/docs/management/persistence/). It is important to understand that, if you start Redis with the default configuration, Redis will spontaneously save the dataset only from time to time. For example, after at least five minutes if you have at least 100 changes in your data. If you want your database to persist and be reloaded after a restart make sure to call the **SAVE** command manually every time you want to force a data set snapshot. Alternatively, you can save the data on disk before quitting by using the **SHUTDOWN** command:
7172

7273
```
7374
$ redis-cli shutdown
7475
```
7576

76-
This way Redis will make sure to save the data on disk before quitting. Reading the [persistence page](/docs/management/persistence/) is strongly suggested in order to better understand how Redis persistence works.
77+
This way, Redis will save the data on disk before quitting. Reading the [persistence page](/docs/management/persistence/) is strongly suggested to better understand how Redis persistence works.
7778

78-
## Install Redis more properly
79+
## Install Redis properly
7980

8081
Running Redis from the command line is fine just to hack a bit or for development. However, at some point you'll have some actual application to run on a real server. For this kind of usage you have two different choices:
8182

@@ -135,8 +136,8 @@ Both the pid file path and the configuration file name depend on the port number
135136
* Set the **pidfile** to `/var/run/redis_6379.pid`, modifying the port as necessary.
136137
* Change the **port** accordingly. In our example it is not needed as the default port is already `6379`.
137138
* Set your preferred **loglevel**.
138-
* Set the **logfile** to `/var/log/redis_6379.log`
139-
* Set the **dir** to `/var/redis/6379` (very important step!)
139+
* Set the **logfile** to `/var/log/redis_6379.log`.
140+
* Set the **dir** to `/var/redis/6379` (very important step!).
140141
* Finally, add the new Redis init script to all the default runlevels using the following command:
141142
142143
```

0 commit comments

Comments
 (0)