{"id":46204,"library":"redsmin","title":"Redsmin Proxy","description":"Redsmin proxy daemon that securely bridges Redis servers behind firewalls or localhost to the Redsmin cloud-based Redis GUI (https://redsmin.com). Current stable version 5.0.1 runs on Node >=6. Provides encrypted tunneling with mutual TLS, supports Docker deployment, automatic reconnection, and configuration via environment variables or files. Compared to manual SSH tunneling, it offers a dedicated proxy with authentication, ready check handling, and integration with Redsmin's management dashboard.","status":"active","version":"5.0.1","language":"javascript","source_language":"en","source_url":"git://github.com/Redsmin/proxy","tags":["javascript","redis","redis-gui","gui","redsmin","proxy"],"install":[{"cmd":"npm install redsmin","lang":"bash","label":"npm"},{"cmd":"yarn add redsmin","lang":"bash","label":"yarn"},{"cmd":"pnpm add redsmin","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Package is a CLI tool, not a library; use via npx for temporary execution.","wrong":"npm install -g redsmin && redsmin","symbol":"CLI","correct":"npx redsmin"},{"note":"Official Docker images are available on Docker Hub; prefer Docker for production.","wrong":"npm run redsmin","symbol":"Docker image","correct":"docker run -e REDSMIN_KEY=... redsmin/proxy"},{"note":"Uses environment variables only; no CLI flags for key or Redis URI.","wrong":"redsmin --key '...'","symbol":"Configuration","correct":"export REDSMIN_KEY='...' && redsmin"}],"quickstart":{"code":"npm install -g redsmin\n\n# Set environment variables\nexport REDSMIN_KEY='your-redsmin-connection-key'\nexport REDIS_URI='redis://127.0.0.1:6379'\nexport REDIS_AUTH='your-redis-password'  # optional\n\n# Start the proxy\nredsmin","lang":"javascript","description":"Installs the redsmin CLI globally, sets required environment variables, and starts the proxy to connect a local Redis instance to Redsmin."},"warnings":[{"fix":"Update Node.js to version 6 or higher, or use the Docker image which bundles a compatible Node version.","message":"The proxy requires Node.js >=6. Earlier versions are not supported and will fail to start.","severity":"breaking","affected_versions":"<5.0.0"},{"fix":"Replace --key with REDSMIN_KEY environment variable; see documentation for full env var list.","message":"Use of CLI flags (e.g., --key) for configuration is deprecated in v4. Only environment variables are supported in v5.","severity":"deprecated","affected_versions":">=4.0.0"},{"fix":"Set the REDIS_AUTH environment variable to your Redis password before starting the proxy.","message":"If your Redis server requires authentication without setting REDIS_AUTH, the proxy will fail with 'NOAUTH Authentication required'.","severity":"gotcha","affected_versions":"all"},{"fix":"Specify the absolute path to the socket file without protocol prefix.","message":"When using a Unix socket for Redis, set REDIS_URI to the socket path (e.g., /tmp/redis.sock) instead of a TCP URI. Using a tcp:// prefix may cause connection failure.","severity":"gotcha","affected_versions":"all"},{"fix":"Migrate from JSON config file to environment variables for all settings.","message":"The CONFIG_FILE environment variable is deprecated in v5. Configuration should be done exclusively via environment variables.","severity":"deprecated","affected_versions":">=5.0.0"}],"env_vars":null,"search_vec":"'5.0.1':27 '6':31 'authent':61 'automat':41 'base':20 'behind':11 'bridg':8 'check':63 'cloud':19 'cloud-bas':18 'compar':50 'configur':44 'current':24 'daemon':5 'dashboard':71 'dedic':58 'deploy':40 'docker':39 'encrypt':33 'environ':46 'file':49 'firewal':12 'gui':22,76,77 'handl':64 'integr':66 'javascript':72 'localhost':14 'manag':70 'manual':52 'mutual':36 'node':30 'offer':56 'provid':32 'proxi':2,4,59,79 'readi':62 'reconnect':42 'redi':9,21,73,75 'redis-gui':74 'redsmin':1,3,17,68,78 'redsmin.com':23 'run':28 'secur':7 'server':10 'ssh':53 'stabl':25 'support':38 'tls':37 'tunnel':34,54 'variabl':47 'version':26 'via':45","created_at":"2026-06-07T12:58:46.860618+00:00","updated_at":"2026-06-07T12:58:46.860618+00:00","problems":[{"fix":"export REDSMIN_KEY='your-key' before running redsmin.","cause":"The REDSMIN_KEY environment variable is not set or is empty.","error":"Error: REDSMIN_KEY required"},{"fix":"Check internet connectivity and DNS resolution; ensure firewall allows outbound HTTPS (port 443) to redsmin.com.","cause":"The proxy cannot resolve the Redsmin server hostname, possibly due to network or DNS issues.","error":"Error: getaddrinfo ENOTFOUND redsmin.com"},{"fix":"Set REDIS_AUTH environment variable to the correct Redis password.","cause":"Redis server requires authentication but REDIS_AUTH is not set or incorrect.","error":"Ready check failed: NOAUTH Authentication required."},{"fix":"Verify Redis is running and accessible; check REDIS_URI for correct host and port.","cause":"The proxy cannot connect to the specified Redis instance; Redis might be down or listening on a different port/host.","error":"Error: Redis connection to 127.0.0.1:6379 failed - connect ECONNREFUSED"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://redsmin.com","github":"git://github.com/Redsmin/proxy","docs":null,"changelog":null,"pypi":null,"npm":"redsmin","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops","database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}