# Hawser

Hawser is a lightweight Go agent that lets Dockhand manage Docker hosts remotely, with standard mode for local-area networks and edge mode for outbound connections behind network address translation or dynamic addresses. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2877/hawser

## Description

Hawser is a lightweight Go agent that lets Dockhand manage Docker hosts remotely, with standard mode for local-area networks and edge mode for outbound connections behind network address translation or dynamic addresses.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

76/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 27 days ago)
- Popular: 57 (671 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- Official website: https://dockhand.pro/
- Unraid: https://ca.unraid.net/apps/hawser-1hc3mkc0aypr48?q=Hawser
- GitHub: https://github.com/Finsys/hawser
- Documentation: https://dockhand.pro/manual/

## Common questions

### What do I need to start Hawser in Standard Mode if it listens on 0.0.0.0?

You must set TOKEN; without it Hawser refuses to start because that would expose the Docker API unauthenticated.

### How can Hawser connect to Dockhand from a host behind NAT or with a dynamic IP?

Use Edge Mode, which initiates an outbound WebSocket connection to Dockhand instead of waiting for inbound connections.

### Where should I put settings for the Hawser systemd service?

Use /etc/hawser/config, setting PORT and TOKEN for Standard Mode or DOCKHAND_SERVER_URL and TOKEN for Edge Mode.

### Can Hawser Edge Mode trust Dockhand's self-signed certificate?

Yes, set CA_CERT to Dockhand's CA certificate; TLS_SKIP_VERIFY is only for insecure testing.

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