# Dockhook

Dockhook is an Unraid plugin that exposes an HTTP endpoint on the host, so a CI pipeline (e.g. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4292/dockhook

## Description

Dockhook is an Unraid plugin that exposes an HTTP endpoint on the host, so a CI pipeline (e.g. GitLab CI) can trigger a Docker container update after a new image is pushed. update_container pulls the new image and recreates the container from its Unraid template, so it keeps its icon, ports, volumes and GUI integration; restart_container does a plain restart; run_userscript runs a User Scripts entry. Requests are authenticated with a shared token compared in constant time, and are restricted to an allowlist of named targets configured on the settings page - no path, image name or command from a request ever reaches a shell.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

38/100 (Low), based on 3 of 4 factors.
- Maintained: 69 (last commit 88 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- GitHub: https://github.com/Lyror/Dockhook
- Unraid: https://ca.unraid.net/apps/dockhook-0wonm0d0nioo81?q=Dockhook

## Common questions

### Where do I find the Dockhook token after installation?

A random token is generated on first install and shown on the Dockhook settings page. Requests are authenticated with that shared token, and only targets listed on that page are accepted.

### How do I point Dockhook at a specific container or User Script?

Configure symbolic target names under Settings -> Dockhook, and the mappings are stored in /boot/config/plugins/dockhook/targets.cfg. Use NAME for the container name shown on the Docker tab, or ID for the User Scripts folder name.

### How do I keep Docker registry credentials for private images after a reboot?

Run docker login on the Unraid server once, then copy /root/.docker/config.json to /boot/config/dockerconfig.json and restore it from /boot/config/go before the emhttp line. This is needed because /root lives in RAM and the login does not survive a reboot by itself.

### Does update_container reset my Unraid Docker container template?

No; update_container pulls the new image and recreates the container from its Unraid template. That keeps the container's icon, ports, volumes, and GUI integration.

### Where do I change the Dockhook port or bind address?

Set the port and bind address on the Dockhook settings page. The same page holds the token, global timeout, and target list.

---
Source: Our Local Host (https://ourlocalhost.com/app/4292/dockhook), the self-hosted and open-source app directory.
