Node.js

Connect to Arctickey from Node.js using ioredis or the official redis client.

ioredis (Recommended)#

ioredis is a robust, full-featured Redis client with built-in support for clustering, sentinel, and streams.

Installation#

Terminal

npm install ioredis

Basic Usage#

TypeScript

import Redis from 'ioredis';

const redis = new Redis({
  host: 'eu.arctickey.com',
  port: 6379,
  password: process.env.ARCTICKEY_PASSWORD,
  tls: {
    rejectUnauthorized: false,
  },
});

// Basic operations
await redis.set('user:1', JSON.stringify({ name: 'Alice' }));
const user = await redis.get('user:1');
console.log(JSON.parse(user));

// With expiration (60 seconds)
await redis.set('session:abc', 'user:1', 'EX', 60);

// Increment
await redis.incr('page:views');

// Lists
await redis.lpush('queue:jobs', 'job-1', 'job-2');
const job = await redis.rpop('queue:jobs');

// Hashes
await redis.hset('product:123', { name: 'Widget', price: 9.99 });
const product = await redis.hgetall('product:123');

Connection String#

TypeScript

import Redis from 'ioredis';

const redis = new Redis(process.env.ARCTICKEY_URL);
// URL format: rediss://:password@eu.arctickey.com:6379

node-redis#

The official Node.js client from Redis Ltd.

Installation#

Terminal

npm install redis

Basic Usage#

TypeScript

import { createClient } from 'redis';

const client = createClient({
  url: 'rediss://:YOUR_PASSWORD@eu.arctickey.com:6379',
  socket: {
    tls: true,
    rejectUnauthorized: false,
  },
});

client.on('error', (err) => console.error('Redis Error', err));

await client.connect();

await client.set('key', 'value');
const value = await client.get('key');

await client.disconnect();

Environment Variables#

Environment

# .env
ARCTICKEY_HOST=eu.arctickey.com
ARCTICKEY_PORT=6379
ARCTICKEY_PASSWORD=your-password-here
ARCTICKEY_URL=rediss://:your-password@eu.arctickey.com:6379

TypeScript

import Redis from 'ioredis';

const redis = new Redis({
  host: process.env.ARCTICKEY_HOST,
  port: parseInt(process.env.ARCTICKEY_PORT || '6379'),
  password: process.env.ARCTICKEY_PASSWORD,
  tls: { rejectUnauthorized: false },
});