How to fix Error: TLSV1_ALERT_PROTOCOL_VERSION (TLS version not supported) in Node.js

# Check running process
ps aux | grep node

# Check Node.js version
node --version

# Look for TLS-related environment variables
env | grep -i tls

# Instead of:
node --tls-v1.0 app.js

# Use:
node app.js  # defaults to TLS 1.2+

# Or explicitly set:
node --tls-min-v1.2 app.js

const https = require('https');

const options = {
  hostname: 'api.example.com',
  port: 443,
  path: '/endpoint',
  method: 'GET',
  minVersion: 'TLSv1.2',  // Enforce TLS 1.2+
  maxVersion: 'TLSv1.3',  // Allow up to TLS 1.3
};

const req = https.request(options, (res) => {
  console.log(`statusCode: ${res.statusCode}`);
});

req.on('error', (error) => {
  console.error(error);
});

req.end();

# Check current version
node --version

# Using nvm (Node Version Manager)
nvm install 18  # or 20, 22 for latest LTS
nvm use 18

# Using npm directly (updates npm, not Node)
npm install -g npm@latest

const https = require('https');
const fs = require('fs');

const options = {
  key: fs.readFileSync('server.key'),
  cert: fs.readFileSync('server.cert'),
  minVersion: 'TLSv1.2',
  maxVersion: 'TLSv1.3',
};

const server = https.createServer(options, (req, res) => {
  res.writeHead(200);
  res.end('Secure connection');
});

server.listen(443);

# View OpenSSL version
openssl version

# For TLS 1.0 or 1.1 support, configure OpenSSL with lower security level
# This requires OpenSSL 1.1.0+ and should only be done for legacy systems

# Set via NODE_OPTIONS:
export NODE_OPTIONS='--openssl-config=/path/to/openssl.cnf'
node app.js