Bolt.new AI and Let's Encrypt integration: Step-by-Step Guide 2025

 

Adding Dependency Configuration in Your Project

 

• Create (or if it already exists, open) your project's package.json file.
• Add the required dependencies for Express and Let's Encrypt integration by including greenlock-express in your dependency list. Since Bolt.new AI does not allow terminal installations, ensure the dependency is specified here.
• Include the following configuration inside your package.json:

• 
  {
    "name": "bolt-new-ai-app",
    "version": "1.0.0",
    "main": "server.js",
    "dependencies": {
      "express": "^4.17.1",
      "greenlock-express": "^4.0.3"
    }
  }
        

 

Creating the Server File for Let's Encrypt Integration

 

• Create a new file named server.ts in the root directory of your Bolt.new AI project.
• This file will be the entry point for your application and will handle HTTPS using Let's Encrypt certificates via the greenlock-express package.
• Paste the following code into server.ts:

• 
  import express from 'express';
  import * as GreenlockExpress from 'greenlock-express';
  
  const app = express();
  // Your application routes
  app.get('/', (req, res) => {
    res.send("Hello, secure world with Let's Encrypt!");
  });
  // Configure Greenlock for automatic SSL certificate generation/renewal
  const greenlock = GreenlockExpress.create({
    // ACME server version, using draft-11 for current Let's Encrypt support
    version: 'draft-11',
    // Directory to store configuration & certificates; ensure the directory exists or Greenlock will create it
    configDir: './greenlock.d',
    // Contact email for important account notifications
    email: 'your-email@example.com',
    // Automatically agree to the Let's Encrypt Subscriber Agreement
    agreeTos: true,
    // Whether to run Greenlock as a community member (set false if you do not want telemetry)
    communityMember: false,
    // List the domains you want to secure with Let's Encrypt
    approveDomains: ['yourdomain.com']
  });
  // Start the server: listen on HTTP port 80 and HTTPS port 443
  greenlock.listen(80, 443, () => {
    console.log("Server is running and SSL certificates are managed by Let's Encrypt");
  });
        

  
  

 

Integrating the Server File into Bolt.new AI Project

 

• If your Bolt.new AI project already has an entry point, update its configuration to point to server.ts as the main file.
• If you usually run a specific command to launch your project, modify it to compile the TypeScript code (if necessary) and then run the resulting JavaScript file. For example, if your project automatically transpiles using a built-in process, ensure that server.ts is included.
• Add or update the run script in your package.json if needed. For example:

  • 
    "scripts": {
      "start": "tsc && node build/server.js"
    }
            

  (Adjust paths based on your project setup.)

 

Final Checks and Testing Your Secure Server

 

• Double-check that you have replaced [email protected] and yourdomain.com with your actual email and domain name in the server.ts file.
• Ensure your project is set to compile TypeScript if it isn’t already configured. Bolt.new AI may handle this automatically if a build configuration is provided.
• Click the Run button in Bolt.new AI. Your application should start on HTTP port 80 and HTTPS port 443, and Greenlock will handle acquiring and renewing Let's Encrypt certificates.
• Monitor the console output to verify that the server starts successfully and that certificate management is active.