Giter Club home page Giter Club logo

localcert's Introduction

Localcert - get valid TLS certificates for your local network

Localcert combines a custom DNS server with Let's Encrypt to make local development with a valid TLS certificate quick and easy.

Installation

Localcert is a normal Go CLI tool. It can be installed with a working Go developer env with:

go install github.com/wildone/localcert/cmd/localcert@latest

You can also download a release binary.

Usage

localcert

This will provision a domain and wildcard certificate like *.fsbli4oliukyh3ydjuzx7q2tdq.user.localcert.dev for your use. The Localcert DNS server will respond to certain subdomains of your domain:

  • localhost.<your subdomain>.user.localcert.dev -> 127.0.0.1
  • ip10-11-12-13.<your subdomain>.user.localcert.dev -> 10.11.12.13
    • This form supports IPs in the following reserved address blocks:
      • 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 (private networks)
      • 169.254.0.0/16 (link-local addresses)
      • 127.0.0.0/8 (loopback addresses)

Params

Usage of C:\projects\github\localcert\bin\localcert.exe:
  -acceptTerms
        accept ACME provider's terms of service
  -acmeAccount string
        path to ACME account file
  -acmeUrl string
        ACME directory URL
  -dataDir string
        default data directory
  -forceRenew
        force renewel of certificate with > 30 days until expiration
  -localCert string
        path to localcert certificate
  -localKey string
        path to localcert certificate key
  -serverUrl string
        localcert server URL (default "https://api.localcert.dev")
  -testPort int
        port for test server (default 8443)

Output

Existing

Found existing certificate for domain "*.wxsm3zde4rwj2j2eimuhfwpgni.user.localcert.dev"
Existing certificate expires in > 30 days and doesn't need to be renewed

Certificate expires 2023-08-24 00:33:15 +0000 UTC

Certificate (chain):  C:\projects\github\localcert\\data\\cert.pem
Certificate privkey:  C:\projects\github\localcert\\data\\key.pem

Force Provision

Found existing certificate for domain "*.wxsm3zde4rwj2j2eimuhfwpgni.user.localcert.dev"
Provisioning domain "*.wxsm3zde4rwj2j2eimuhfwpgni.user.localcert.dev"...

Certificate expires 2023-08-24 00:33:15 +0000 UTC

Certificate (chain):  C:\projects\github\localcert\\data\\cert.pem
Certificate privkey:  C:\projects\github\localcert\\data\\key.pem

Create

Provisioning domain "*.j6liixjthh7wfankaazyq3f36m.user.localcert.dev"...
Domain provisioned; waiting for certificate generation...

Certificate expires 2023-08-26 04:52:14 +0000 UTC

Certificate (chain):  C:\projects\github\localcert\\data\\cert.pem
Certificate privkey:  C:\projects\github\localcert\\data\\key.pem

localcert's People

Contributors

wildone avatar lann avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.