Skip to main content

Binary Installation

It is recommended for ordinary users.

Prerequisites​

Supported operating systems:

  • Linux Kernel 3.2 or higher
  • macOS 12 Monterey or higher
  • Windows 10 / Windows Server 2016 or higher

Download​

Download the archived package of precompiled binary files directly from GitHub Releases.

Run​

Once you've extracted the archive, you could start the application by running in the extracted directory:

./certimate serve
tip

When using CMD as the terminal on Windows, the suffix .exe cannot be omitted.

.\certimate.exe serve
tip

You may see a prompt saying on macOS: "'certimate' can't be opened because Apple cannot check it for malicious software."

You can go to "System Settings" -> "Privacy & Security" -> "Security", then click "Allow Anywhere", and try run again.

Autorun at startup boot​

Certimate needs to run in the background in order to automatically renew certificates.

Linux​

You can use systemd to manage service.

  1. Create a service file in the /etc/systemd/system/ directory:
sudo vi /etc/systemd/system/certimate.service
  1. Configure the service:
[Unit]
Description=Certimate
After=network.target

[Service]
# Replace the path with your actual installation path
WorkingDirectory=/usr/sbin/certimate/
ExecStart=/usr/sbin/certimate/certimate serve
Restart=on-failure
User=root
PrivateTmp=true

[Install]
WantedBy=multi-user.target
  1. Enable and start the service
# Enable service
sudo systemctl enable certimate.service

# Start service
sudo systemctl start certimate.service

Windows​

You can add a autorun startup item in the Windows Registry.

Create a new text file with a suffix of .reg (e.g., certimate.reg), write the following content, save the file, and double-click to run:

Windows Registry Editor Version 5.00

; Replace the path with your actual installation path
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run]
"Certimate"="\"C:\\certimate\\certimate.exe\" serve"

And you can also register a Windows Service using the command:

# Install
.\certimate.exe winsc install --http 127.0.0.1:8090

# Uninstall
.\certimate.exe winsc uninstall

macOS​

You can use launchd to manage service.