Self-signed certificates

Some users may come across a barrier, where they're unable to receive a 200 response from the Ping module for some services, while using self-signed certificates or a local certificate authory.

What's going on?

Homarr is trying to communicate to your services via the integrations. It usually doesn't matter if Homarr is running on http or https. Your services have a self-signed certificate - Homarr will recognize that the certificate was signed by an unknown authority and requests will be blocked.

Sadly, you can't add your self-signed certificates to Homarr yet. But you can deactivate the rejection for unauthorizes TLS requests. Simply add the NODE_TLS_REJECT_UNAUTHORIZED environment variable and set it to 0.

Example with Docker Run

Terminal

docker run  \
  --name homarr \
  --restart unless-stopped \
  -p 7575:7575 \
  -v ./homarr/configs:/app/data/configs \
  -v ./homarr/icons:/app/public/icons \
  -e NODE_TLS_REJECT_UNAUTHORIZED=0 \
  -d ghcr.io/ajnart/homarr:latest

Example with Docker Compose

docker-compose.yml

version: '3'
#---------------------------------------------------------------------#
#                Homarr -  A homepage for your server.                #
#---------------------------------------------------------------------#
services:
  homarr:
    container_name: homarr
    image: ghcr.io/ajnart/homarr:latest
    restart: unless-stopped
    volumes:
      - ./homarr/configs:/app/data/configs
      - ./homarr/icons:/app/public/icons
    environment:
      NODE_TLS_REJECT_UNAUTHORIZED: 0
    ports:
      - '7575:7575'