Skip to content

How to Create a Self-Signed Certificate with OpenSSL

DodaTech Updated 2026-06-24 2 min read

Self-signed certificates are useful for development, testing, and internal services where a public CA is unnecessary. This guide walks through the specific troubleshooting steps to diagnose and resolve self-signed certificate creation issues.

Before You Begin

Before you begin, be sure to have the following in place:

  • A Linux server with the relevant software installed
  • Access to the command line interface
  • Appropriate permissions (root or sudo)

Quick Fix

Wrong

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout key.pem -out cert.pem

Wrong: Self-signed cert without SAN extensions

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout key.pem -out cert.pem -subj "/CN=localhost" -addext "subjectAltName=DNS:localhost,DNS:*.local,IP:127.0.0.1"

Right: Self-signed cert with SANs for local development

Output

Certificate:\n    Issuer: CN=localhost\n    Subject: CN=localhost\n    X509v3 Subject Alternative Name:\n        DNS:localhost, DNS:*.local, IP:127.0.0.1

Prevention

To avoid future issues, follow these best practices:

  • Always include SAN extensions -- browsers reject certificates without SAN
  • Set an appropriate validity period -- 365 days for development certs
  • Use different certificates for development, staging, and production
  • Add the self-signed CA to your system trust store to avoid browser warnings
  • Use openssl verify -CAfile ca.pem cert.pem to test the certificate chain

DodaTech Tools

For further assistance with any of the above issues, consider using DodaTech consulting services or DodaTech tutorials for more in-depth guidance.

Common Mistakes with self signed

  1. Mixing let bindings with <- bindings in do notation, producing type errors
  2. Overlapping type class instances that cause GHC to reject the program with ambiguous dispatch errors
  3. Non-exhaustive pattern matches that compile with warnings then crash at runtime

These mistakes appear frequently in real-world OPENSSL code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

Why does my self-signed certificate show Not Secure in the browser?|||Self-signed certificates are not trusted by browsers by default. You must add the certificate to the operating system trusted root store.
Can I use a self-signed certificate in production? No. Self-signed certificates trigger browser security warnings and break API clients that verify certificates. Use a certificate from a trusted public CA like Let's Encrypt.

Built by the developers of DodaTech

Doda Browser, DodaZIP & Durga Antivirus Pro