https://github.com/IBM-Cloud/redli

Redli - A humane alternative to the Redis-cli and TLS
https://github.com/IBM-Cloud/redli

command-line-tool redis redis-client ssl-support tls-support

Last synced: about 2 months ago
JSON representation

Redli - A humane alternative to the Redis-cli and TLS

• Host: GitHub
• URL: https://github.com/IBM-Cloud/redli
• Owner: IBM-Cloud
• License: apache-2.0
• Created: 2018-08-17T15:18:36.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-04-05T10:18:52.000Z (9 months ago)
• Last Synced: 2024-10-31T00:44:02.676Z (2 months ago)
• Topics: command-line-tool, redis, redis-client, ssl-support, tls-support
• Language: Go
• Size: 28.1 MB
• Stars: 272
• Watchers: 16
• Forks: 22
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Redli - a humane alternative to redis-cli

[![Release](https://img.shields.io/github/release/IBM-Cloud/redli.svg)](https://github.com/IBM-Cloud/redli/releases/latest)

## About

Redli is a Go-based alternative to the official Redis-cli application. It's major feature is that it mimics the redis-cli command line argurments while also understanding rediss: protocols and supporting a `--tls` flag allowing it to connect to TLS/SSL secured Redis without the need for tunnels. It also has a number of flags and environment variables for passing server certificates over as files or base64 strings. Note, passing a certificate turns TLS on by default.

## Installation

You can download the binary for your OS from the [releases page](https://github.com/IBM-Cloud/redli/releases). Un-tar the file, then `chmod +x` the binary and move it to your path.

You can also compile Redli with **go** using these steps (Go 1.8+ required):

1. `go get -u github.com/IBM-Cloud/redli`

2. `go install github.com/IBM-Cloud/redli`

## Usage

```text

 redli [] [...]

      --help               Show context-sensitive help (also try --help-long and --help-man).

      --debug              Enable debug mode.

      --long               Enable long prompt with host/port

  -u, --uri=URI            URI to connect to

  -h, --host="127.0.0.1"   Host to connect to

  -p, --port=6379          Port to connect to

  -a, --auth=AUTH          Password to use when connecting

  -n, --ndb=0              Redis database to access

      --tls                Enable TLS/SSL

      --skipverify         Insecure option to skip server certificate validation

      --certfile=CERTFILE  Self-signed certificate file for validation

      --certb64=CERTB64    Self-signed certificate string as base64 for validation

      --raw                Produce raw output

      --eval=EVAL          Evaluate a Lua script file, follow with keys a , and args

      

Args:

  []  Redis commands and values

```

* `URI`  URI to connect to. It follows the format of [the provisional IANA spec for Redis URLs](https://www.iana.org/assignments/uri-schemes/prov/redis), but with the option to denote a TLS secured connection with the protocol rediss:.

e.g. `INFO KEYSPACE`

Be aware of interactions with wild cards and special characters in the shell; quote and escape as appropriate.

## License

Redli is (c) IBM Corporation 2018-2024. All rights reserved.

Redli is released under the Apache 2 License.

Attribution: The `commands.json` file is by Salvatore Sanfillipo.

In the process of building the application, the commands.json file of the Redis-docs repository is retrieved and incorporated into the code. This file is distributed under a CC-BY-SA 4.0 license (see [Copyright](https://github.com/antirez/redis-doc/blob/master/COPYRIGHT)).