---
name: "gdnsd-plugin-http_status"
section: "8"
platform: "linux"
package: "gdnsd"
version: "3.8.3-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gdnsd-plugin-http_status"
---

# gdnsd-plugin-http\_status(8)

gdnsd HTTP monitoring plugin

## NAME

gdnsd-plugin-http\_status - gdnsd HTTP monitoring plugin

## SYNOPSIS

Example http\_status service\_types config:

```
  service_types => {
    webcheck => {
      plugin => http_status,
      port => 8080,             # default 80
      url_path => /checkme      # default '/'
      vhost => www.example.com  # default none
      ok_codes => [ 200, 301 ], # default [ 200 ]
      up_thresh => 20,
      ok_thresh => 10,
      down_thresh => 10,
      interval => 10,
      timeout => 3,
    }
  }
```

## DESCRIPTION

**gdnsd-plugin-http\_status** is a monitoring plugin that checks basic HTTP service.

## PARAMETERS

- port

  The numeric port number to connect on, default `80`.

- url\_path

  The string URL to GET from the remote service, default `"/"`

- vhost

  The string hostname to supply as a `"Host:"` header with the request.  No default.  If unspecified, no `"Host:"` header is sent at all.

- ok\_codes

  An array of integer HTTP status codes which are acceptable as positive responses.  The default is `"[ 200 ]"`.

## SEE ALSO

[**gdnsd.config**(5)](/gdnsd.config/5.md), [**gdnsd.zonefile**(5)](/gdnsd.zonefile/5.md), [**gdnsd**(8)](/gdnsd/8.md)

The gdnsd manual.

## COPYRIGHT AND LICENSE

Copyright (c) 2014 Brandon L Black \<blblack@gmail.com\>

This file is part of gdnsd.

gdnsd is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

gdnsd is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with gdnsd.  If not, see \<http://www.gnu.org/licenses/\>.