Node64 documentation

Everything you need for Node64 in one place: from installation through the four modules to the API. Every page is written with beginners in mind, yet still covers all options and defaults.

Node64 is a lightweight Docker container for your home network: health checks, a DynDNS updater for ipv64.net, DNS64 as a DNS filter with blocklists, PROXY64 as a reverse proxy and Honeypot64 with the community blocklist. It all ships as a single Go binary with SQLite – no database server, no runtime dependencies. Node64 runs fully on its own; connecting it to your ipv64.net account is optional.

Quick start in 60 seconds

  1. Start the container. One command is all it takes; your data goes into the node64-data volume:
    bash 
    docker run -d --name node64 \
  -p 8080:8080 \
  -v node64-data:/data \
  --restart unless-stopped \
  ghcr.io/ipv64net/node64:latest
  2. Open the web interface. Browse to http://<host>:8080, where <host> is the IP address or name of the machine running Docker.
  3. Set it up. The wizard asks for your language and an admin account. There is no default password. Afterwards, turn on the modules you need under Settings → Modules.
Image coming soon

The ghcr.io/ipv64net/node64:latest image is currently being prepared for release. The commands on these pages will work as soon as it is public.

More variants (docker compose, host network, Docker socket) are covered in Installation; the tour after the first start is in First steps.

System requirements

  • Docker on Linux, optionally with Docker Compose.
  • Architecture: linux/amd64, linux/arm64 or linux/arm/v7 – a PC, server, VM, NAS or Raspberry Pi.
  • A volume for /data – the only directory Node64 writes to.
  • Port 8080 available for the web interface (HTTP and HTTPS on the same port).
  • No account required. An ipv64.net account unlocks additional online features.

All sections

Getting started

Installation

docker run and docker compose, platforms, ports, permissions and the /data volume.

First steps

Setup wizard, dashboard, enabling modules, your first check and your first notification.

Configuration

Every NODE64_* variable, network modes, running behind a reverse proxy, logs and appearance.

Update & backup

Self-update or a new image, full backups, restoring, export/import and resetting the node.

Modules

Health checks

Eleven check types, maintenance windows, Docker checks and outside checks via ipv64.net.

Proxmox VE

Monitor nodes, VMs and containers read-only – crashes, restarts, CPU, RAM and disk.

Docker

All containers locally and on remote hosts – via SSH, TLS or socket proxy, with history and rules.

Notifications

E-mail, Telegram, Discord, Slack, Microsoft Teams, Matrix, ntfy, Gotify, Pushover, Home Assistant, webhooks – with protection against alert noise.

PROXY64 reverse proxy

Proxy hosts, redirects, TLS passthrough, TCP/UDP streams and access lists.

CDN64

Publish services through a tunnel without port forwarding – even on DS-Lite connections.

Certificates

Let's Encrypt via HTTP or DNS challenge, your own CA and uploads, all in one place.

DNS64

DNS filter with blocklists, allowlist, custom records and DoH/DoT/DoQ.

DynDNS64

Keep your ipv64.net domains up to date on IPv4 and IPv6 automatically.

Honeypot64 Preview

Trap services for SSH, Telnet, web, mail, FTP and TCP – see who knocks. Also as a pure sensor.

System & security

Sovereignty & data flows

All outgoing connections – and why everything exchanged with ipv64.net stays in Germany.

Login & security

Two-factor, passkeys, SSO via OpenID Connect, forward auth and the audit log.

Connect ipv64.net

API key and health check sync: what you gain online – and what works without an account.

Cluster

Several nodes sync checks, certificates and more directly with each other – even without an ipv64 account.

Integrations

Local API

Everything the interface can do, as a JSON API with API keys and OpenAPI 3.1.

Prometheus

Metrics for every module at /api/metrics, with example alerting rules.

AI interface (MCP)

Claude Code, Cursor and VS Code read the node's state – read-only, home network only.

Help

FAQ & troubleshooting

Ports already in use, ICMP without root, the Docker socket, logs and common questions.

Official forum v64.tech

Ask questions about Node64, find solutions and connect with the community.

ipv64.net wiki

Everything about your ipv64.net account, DynDNS and the online services.

Next →Installation

Something unclear, missing, or a question about Node64? Ask in the official forum v64.tech.

Questions about Node64?
For any questions about the product, use the official forum: setup, troubleshooting, ideas and exchange with the community and the ipv64.net team.
Go to the forum v64.tech