How to create connection to Redis server (aka Redis Standalone)?

You can create connection to standalone installed Redis server with version 2.8.0 or later. Since this version Redis support SCAN command.

  1. In the top left corner of app, click Connection button and select New Redis Connection… menu item.

    New Redis Standalone Connection menu item

  2. Type connection name to Name field.
  3. Specify Redis server host name or IP in Host filed.
  4. Leave default Redis port 6379 or specify custom in Port field.
  5. Type password to Password field if Redis server required authentication or leave it blank.
  6. Specify database number.

    If you want to create connections to all databases with keys then check Create connections for all databases checkbox.

  7. Click Test Connection button for establish test connection to specified Redis server. In case of error read error message and fix problem.
  8. Click OK button.

How to create connection to Redis Sentinel?

  1. In the top left corner of app, click Connection button and select New Redis Sentinel Connection… menu item.

    New Redis Sentinel Connection menu item

  2. Type connection name to Name field.
  3. Specify host name or IP of any Redis Sentinel node in Host filed (other nodes of Redis Sentinel cluster will be discovered automatically).
  4. Leave default Redis Sentinel port 26379 or specify custom in Port field.

    In this filed Redis Sentinel port must be specified. Don’t mix it with Redis server port.

  5. Type Master Id of Redis Sentinel cluster in Master Id field.
  6. Type password to Password field if Redis server required authentication or leave it blank.
  7. Specify database number.

    If you want to create connections to all databases with keys then check Create connections for all databases checkbox.

  8. Click Test Connection button for establish test connection to specified Redis Sentinel server. In case of error read error message and fix problem.
  9. Click OK button.

How to create connection to Redis Cluster?

  1. In the top left corner of app, click Connection button and select New Redis Cluster Connection… menu item.

    New Redis Cluster Connection menu item

  2. Type connection name to Name field.
  3. Specify host name or IP of any Redis Cluster node in Host filed (other nodes of Redis Cluster will be discovered automatically).
  4. Leave default Redis Cluster port 6379 or specify custom in Port field.
  5. Type password to Password field if Redis server required authentication or leave it blank.
  6. Click Test Connection button for establish test connection to specified Redis Sentinel server. In case of error read error message and fix problem.
  7. Click OK button.

How to create connection to LevelDB database?

You can create connection to LevelDB database with version 1.14 or later.

Keylord doesn’t support LevelDB databases with custom comparators.

  1. In the top left corner of app, click Connection button and select New LevelDB Connection… menu item.

    New LevelDB Connection menu item

  2. Type connection name to Name field.
  3. Specify path to directory with LevelDB database in LevelDB Directory field or select is use browse file dialog (...).
  4. Click Test Connection button for establish test connection to specified LevelDB database. In case of error read error message and fix problem.
  5. Click OK button.

How to create connection to Memcached server?

  1. In the top left corner of app, click Connection button and select New Memcached Connection… menu item.

    New Memcached Connection menu item

  2. Type connection name to Name field.
  3. Specify Memcached server host name or IP in Host filed.
  4. Leave default Memcached port 11211 or specify custom in Port field.
  5. Choose protocol type supported by Memcached server.

    Binary protocol support authentication but doesn’t support debug command for retrieve chunk of keys.

    1. Type user name to Username field if Memcahced server required authentication or leave it blank.
    2. Type password to Password field if Redis server required authentication or leave it blank.

    Text protocol doesn’t support authentication but support debug command for retrive chunk of keys.

  6. Click Test Connection button for establish test connection to specified Memcached server. In case of error read error message and fix problem.
  7. Click OK button.

How to create empty LevelDB database?

You can create empty LevelDB database with version 1.18.

  1. In the top left corner of app, click Connection button and select New LevelDB Connection… menu item.

    New LevelDB Connection menu item

  2. Click Create… button near by LevelDB Directory field and specify path to directory where will be created new empty LevelDB database.


How to create SSH tunnel for Redis or Memcached connection?

Keylord has ability to create secure SSH tunnel between your computer and remote server and establish connection to Redis or Memcached database through this tunnel.

  1. Select Redis or Memcached connection in connection list, click right mouse button and select Edit Connection menu item.
  2. Click SSH Tunnel tab.
  3. Check Use SSH Tunnel checkbox checkbox.
  4. Specify remote server host name or IP and port in Host and Port fields.
  5. Type remote user name in User field.
  6. Keylord support two types of SSH authentication: by password and by public key. Choose one in Authentication Method field.

    • Authentication by password required password of user.

      1. Type user password to Password field.
    • Authentication by public key required private key on your computer.

      1. Specify path to private key in Private Key field.
      2. Type passphrase of private key in Passphrase if required or leave it blank.
  7. Click Test Connection button for establish test connection to specified Redis server. In case of error read error message and fix problem.
  8. Click OK button.

How to create SSL connection to Redis server?

Redis server doesn’t support SSL out of th box but some services provide access to Redis over SSL use third-party solutions to organize SSL connections like stunnel.

  1. Select Redis or Memcached connection in connection list, click right mouse button and select Edit Connection menu item.
  2. Click SSL tab.
  3. Check Use SSL checkbox.
  4. Specify path to Root Certificate Authority (CA) certificate in PEM format if Redis server are using self-signed SSL certificates or leave it blank.

    If you don’t have CA possible to establish SSL connection without it but less secure. Uncheck Verify Host checkbox. In this case Keylord will now verify remove host name because it doesn’t have trusted CA.

  5. Click OK button.

How to create Redis connection to Redis Labs over SSL?

To use SSL with your Redis Labs resource, it must belong to a paid plan that supports SSL.

Enable SSL for Redis database
  1. Login to your account and navigate to the details page of your resource and click the Edit button.
  2. Under the Access Control & Security section, make sure that the SSL Client Authentication box is checked.
  3. Set the resource’s client certificate using one of the following ways.
  4. Bring your own key:
    1. If you have your own X.509-compliant certificate, simply paste it to the textbox with the Enter Client Certificate placeholder.
    2. Click the Download Redis Labs’ Certification Authority link to obtain the service certification authority. 2. Generate a certificate:
    3. Use the Generate Client Certificate button to generate a client certificate.
    4. The generated certificate’s public key will be displayed in the textbox.
    5. This will also trigger an automatic download of a zip archive with the following contents:
      • garantia_user.crt - the certificate’s public key.
      • garantia_user_private.key - the certificate’s private key.
      • garantia_ca.pem - the Redis Labs’ Certification Authority.
  5. Click the Update button to apply the changes to your resource.

Important: Once SSL is enabled, your resource will not accept regular, non-SSL connections.

Create Redis connection over SSL in Keylord
  1. In the top left corner of app, click Connection button and select New Redis Connection… menu item.

    New Redis Standalone Connection menu item

  2. Type connection name to Name field.
  3. Specify Redis server host name or IP in Host filed.
  4. Leave default Redis port 6379 or specify custom in Port field.
  5. Type password to Password field if Redis server required authentication or leave it blank.
  6. Specify database number.

    If you want to create connections to all databases with keys then check Create connections for all databases checkbox.

  7. Click SSL tab.
  8. Download Root Redis Labs’ Certificate Authority (CA) file from Redis Lab (usually it has garantia_ca.pem name).
  9. Specify path to garantia_ca.pem file in Root CA Certificate file.

  10. Click Test Connection button for establish test connection to specified Redis server. In case of error read error message and fix problem.
  11. Click OK button.

How to delete connection to Redis, LevelDB or Memcached from connection list?

  1. Select Redis, LevelDB or Memcached connection in connection list, click right mouse button and select Delete Connection… menu item.
  2. Click OK in confirmation dialog.

How to rearrange connections in connection list?

  1. Select connection and drag it.

    Drag and Drop connection

  2. Drop it over other connection and dragged connection will be inserted before it.