diff --git a/docs/marketplace-docs/guides/redis/index.md b/docs/marketplace-docs/guides/redis/index.md index 49209274ff3..04582fd7fe9 100644 --- a/docs/marketplace-docs/guides/redis/index.md +++ b/docs/marketplace-docs/guides/redis/index.md @@ -2,7 +2,7 @@ title: "Deploy Redis through the Linode Marketplace" description: "This guide shows how you can install Redis database, a open-source, in-memory, data structure store, with optional write and persistence of data on a disk." published: 2020-03-13 -modified: 2022-03-08 +modified: 2025-04-03 keywords: ['redis','data store','cluster','database'] tags: ["linode platform","database","marketplace","cloud-manager"] external_resources: @@ -18,6 +18,8 @@ marketplace_app_name: "Redis" [Redis](https://redis.io/) is an open-source, in-memory, data-structure store, with the optional ability to write and persist data to a disk, which can be used as a key-value database, cache, and message broker. Redis features built-in transactions, replication, and support for a variety of data structures such as strings, hashes, lists, sets, and others. +The One-Click App for Redis installs Redis version 7.2.7. + ## Deploying a Marketplace App {{% content "deploy-marketplace-apps-shortguide" %}} @@ -30,30 +32,62 @@ marketplace_app_name: "Redis" ## Configuration Options -- **Supported distributions:** Debian 11, Ubuntu 20.04 LTS -- **Recommended minimum plan:** All plan types and sizes can be used, though consider using a [High Memory Compute Instance](https://www.linode.com/products/high-memory/) for larger databases in a production environment. +- **Supported distributions:** Ubuntu 24.04 LTS +- **Suggested minimum plan:** All plan types and sizes can be used, though consider using a [High Memory Compute Instance](https://www.linode.com/products/high-memory/) for larger databases in a production environment. ### Redis Options -{{% content "marketplace-limited-user-fields-shortguide" %}} +{{% content "marketplace-required-limited-user-fields-shortguide" %}} + +### Self Signed SSL/TLS Options + +- **Country or Region:** Enter the country or region for you or your organization. + +- **State or Province:** Enter the state or province for you or your organization. + +- **Locality:** Enter the town or other locality for you or your organization. -{{% content "marketplace-custom-domain-fields-shortguide" %}} -- **Email address for the SOA record:** The start of authority (SOA) email address for this server. This is a required field if you want the installer to create DNS records. +- **Organization:** Enter the name of your organization. + +- **Email Address:** Enter the email address you wish to use for your certificate file. + +- **CA Common Name:** Enter a common name to be shared as the authority for all SSL certificates, for example *Redis CA*. + +- **Client Count:** Generate up to ten SSL certificates for external clients connecting to Redis. {{% content "marketplace-special-character-limitations-shortguide" %}} ## Getting Started after Deployment -### Access the Redis CLI +### Obtain the Credentials -1. Log in to your new Compute Instance through [Lish](/docs/products/compute/compute-instances/guides/lish/) or [SSH](/docs/guides/connect-to-server-over-ssh/) using either the `root` user or limited user and the associated password you entered when creating the instance. +Once the app is deployed, you need to obtain the credentials from the server. + +To obtain credentials: + +1. Log in to your new Compute Instance using one of the methods below: + + - **Lish Console**: Log in to Cloud Manager, click the **Linodes** link in the left menu, and select the Compute Instance you just deployed. Click **Launch LISH Console**. Log in as the `root` user. To learn more, see [Using the Lish Console](/docs/products/compute/compute-instances/guides/lish/). + - **SSH**: Log in to your Compute Instance over SSH using the `root` user. To learn how, see [Connecting to a Remote Server Over SSH](/docs/guides/connect-to-server-over-ssh/). + +1. Run the following command to access the credentials file: + + ```command + cat /home/$USERNAME/.credentials + ``` + +This returns passwords that were automatically generated when the instance was deployed. Save them. Once saved, you can safely delete the file. + + +### Access the Redis CLI +After you log in and obtain the credentials, you can use the Redis CLI. Redis is configured to require authentication for the default user, and a valid client SSL certificate. -1. To use the redis-cli, run either of the commands below: +To access the Redis CLI, run the command: - - `redis-cli`: This opens the interactive mode where you can type in whichever commands you wish. - - `redis-cli [argument]`, where *[argument]* is the argument or command you wish to run. For instance, running `redis-cli ping` should result in the output of `PONG` if redis is configured properly. +`redis-cli --tls --cacert /etc/redis/ssl/ca/ca.crt --cert /etc/redis/ssl/certs/client1.crt --key /etc/redis/ssl/keys/client1.key.pem -a $REDIS_DEFAULT_USER_PASSWORD` -For more information about the redis-cli and the commands you have available, see [redis-cli, the Redis command line interface](https://redis.io/topics/rediscli). +This opens the interactive mode where you can type commands. To learn more on the Redis CLI and available commands, see [Redis CLI +](https://redis.io/topics/rediscli). ### Determining How to Use Redis