logo
Getting StartedQuickstart
Getting Started

Quickstart

Get oriented quickly. Find the right section for your use case — whether you want to use our tools, our mail forwarding service, or self-host the entire stack.

Choose Your Path

Open Source Tools — Quick Install

All tools require Go 1.22+. Install any tool with a single command:

Reverse DNS, subdomain, and CNAME lookups on 5.14B+ domains. No API key needed.

go install github.com/haltman-io/ip-thc/cmd/ip-thc@latest
ip-thc -rdns -t 1.1.1.1
ip-thc -sub -t example.com --all
ip-thc -cn -t github.io

Mail Forwarding — Quick Start

Create a free email alias in seconds at forward.haltman.io:

Choose your alias

Pick a handle, select a domain, and enter your destination email address.

Confirm via email

Check your inbox for a confirmation link (anti-abuse measure).

Start receiving

Emails sent to your alias are forwarded to your real inbox immediately.

Or use the API directly via cURL:

curl 'https://mail.haltman.io/forward/subscribe?name=myalias&domain=fwd.haltman.io&to=you%40email.com'

Self-Hosting — Overview

The full stack consists of these components, deployed in order:

#ComponentRole
1MariaDBDomain and alias lookup backend
2DNSMX, SPF, DMARC, PTR records
3PostSRSdSender Rewriting Scheme (SPF alignment)
4PostfixSMTP engine and policy enforcement
5OpenDKIMDKIM signing (optional, recommended)
6mail-forwarding-apiNode.js API for alias management
7mail-forwarding-uiNext.js frontend

Start with the mail-forwarding-core guide — it covers components 1–5 in a single document.

Community & Support

Was this page helpful?
Built with Documentation.AI

Last updated today