---
title: "Deploy Web-Check | (Just Updated) Website OSINT Analyzer, DNS, SSL, Ports and Headers, Not Open to the Internet"
description: "Web-Check website analyzer: DNS, SSL, headers, port scan API behind a login"
category: "Other"
url: https://railway.com/deploy/web-check-or-just-updated-website-osint-
---

# Deploy Web-Check | (Just Updated) Website OSINT Analyzer, DNS, SSL, Ports and Headers, Not Open to the Internet

Web-Check website analyzer: DNS, SSL, headers, port scan API behind a login

**[Deploy Web-Check | (Just Updated) Website OSINT Analyzer, DNS, SSL, Ports and Headers, Not Open to the Internet on Railway](https://railway.com/template/web-check-or-just-updated-website-osint-)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/web-check-or-just-updated-website-osint-/manifest.json

- **Creator:** SuperSlowSloth
- **Category:** Other

## Template content

### web-check

- **Image:** ghcr.io/bon5co/web-check-railway:2.4.2@sha256:133d6854532113b07b111bda0d67225c9e6377479eb2b8bcddeddb9a69cddd90
- **Health check:** /healthz
- **Public domain:** Yes

## Documentation

# Deploy and Host Web-Check on Railway

**Built for an LLM agent to deploy and use.** The deploy form has no fields to fill: the login password is generated, the whole site and its API sit behind that login, and there is nothing to configure. Web-Check is a self-hosted website analyzer: give it a URL and it returns the DNS records, TLS certificate, HTTP headers, open ports, redirect chain, tech stack, cookies, security headers, carbon footprint and a screenshot, as a browser dashboard or as a JSON API. A free, self-hosted alternative to a pile of one-off OSINT and site-audit web tools.

## About Hosting Web-Check

This template runs one service, **web-check**: the upstream Web-Check 2.4.2 image, pinned by digest, through a thin wrapper. It keeps no state, so it needs no volume and no database. One public domain serves the dashboard at `/check` and the API at `/api`. The listener is on Railway's injected `PORT`, and the healthcheck is `GET /healthz`.

**What the wrapper fixes.** Upstream Web-Check has no login at all, and its `/api` endpoints fetch, port-scan and screenshot any address a visitor names, from your Railway project's IP address. A plain deploy is therefore an open scanner that anyone who finds the domain can aim at a third party in your name. The wrapper runs upstream's server on a loopback port and puts a login proxy on the public port: user `admin`, password from the `ADMIN_PASSWORD` variable, accepted as HTTP Basic or as `Authorization: Bearer`. Only `GET /healthz` is open. The container refuses to start if `ADMIN_PASSWORD` is empty.

**Using it.** Open the domain, sign in as `admin` with `ADMIN_PASSWORD`, and enter a URL. From code, call `GET /api/CHECK?url=SITE` with the Bearer header, for example `/api/dns`, `/api/ssl`, `/api/headers`, `/api/ports`, `/api/screenshot`. A check that needs a network path Railway does not provide may report an error for that one check; the others are unaffected.

### Agent contract

- Public URL: `https://RAILWAY_PUBLIC_DOMAIN` (the generated domain of the `web-check` service)
- Private URL: `http://web-check.railway.internal:8080`
- Credentials: the variable `ADMIN_PASSWORD` on the `web-check` service is the password of the user `admin`
- Auth: send `Authorization: Bearer ADMIN_PASSWORD value` on every call (HTTP Basic `admin:ADMIN_PASSWORD value` also works). Without it every path except `GET /healthz` answers 401 with `{"error":"authentication required"}`, and so does a wrong key. Web-Check's own API is read-only (GET); a write request without a key answers `write without key: 401`. There is no sign-up.
- Health: `GET /healthz` returns 200 with `{"status":"ok","ready":true,"version":...}`

```bash
#!/bin/sh
# needs: RAILWAY_PUBLIC_DOMAIN, ADMIN_PASSWORD (variables of the web-check service); also curl, grep.
# write-auth: the write request below carries no key and is refused; Web-Check's own API is read-only (GET)
# signup: none - Web-Check has no account registration; the only login is `admin`, set from ADMIN_PASSWORD
R="https://$RAILWAY_PUBLIC_DOMAIN"; T="url=example.com"
n=0; until [ "$(curl -s -o /dev/null -w '%{http_code}' "$R/healthz")" = 200 ]; do n=$((n+1)); [ "$n" -le 60 ] || break; sleep 5; done
curl -s -o /dev/null -w "health: %{http_code}\n" "$R/healthz"
# a stranger gets nothing: no UI, no scan, no screenshot
curl -s -o /dev/null -w "page without key: %{http_code}\n" "$R/check"
curl -s -o /dev/null -w "scan without key: %{http_code}\n" "$R/api/dns?$T"
curl -s -o /dev/null -w "scan wrong key: %{http_code}\n" -H "Authorization: Bearer not-the-password" "$R/api/dns?$T"
curl -s -X POST -o /dev/null -w "write without key: %{http_code}\n" "$R/api/dns?$T"
curl -s -X POST -o /dev/null -w "write wrong key: %{http_code}\n" -H "Authorization: Bearer not-the-password" "$R/api/dns?$T"
# with the generated password (Bearer here; HTTP Basic admin:ADMIN_PASSWORD works for a browser)
A="Authorization: Bearer $ADMIN_PASSWORD"
curl -s -o /dev/null -w "page with key: %{http_code}\n" -H "$A" "$R/check"
curl -s -o /dev/null -w "scan with key: %{http_code}\n" -H "$A" "$R/api/dns?$T"
if curl -s -H "$A" "$R/api/dns?$T" | grep -q '"A":\['; then echo "dns answer: found"; else echo "dns answer: MISSING"; fi
if curl -s -H "$A" "$R/api/ssl?$T" | grep -q '"subject"'; then echo "tls answer: found"; else echo "tls answer: MISSING"; fi
```

Expected output against a fresh deploy (measured on a Railway deploy of the generated draft):

```text
health: 200
page without key: 401
scan without key: 401
scan wrong key: 401
write without key: 401
write wrong key: 401
page with key: 200
scan with key: 200
dns answer: found
tls answer: found
```

The refusals are the contract: `page without key`, `scan without key`, `scan wrong key`, `write without key` and `write wrong key` all answer 401. Web-Check has no account registration, so the snippet declares `signup: none`.

## Why Deploy Web-Check on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Web-Check on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

- **Agent-ready** - no deployer fields, a contract block, and one script that proves a stranger is refused and the generated password opens the scanner.
- **Not an open scanner** - upstream has no login and will probe any address for anyone; here every path sits behind one.
- **Stateless** - nothing to back up, nothing to lose on a redeploy.
- **Pinned** - the upstream image is pinned by digest and the wrapper by tag and digest.

## Common Use Cases

- **Site audit before launch** - headers, TLS, redirects, cookies and security headers of a site in one call.
- **Domain due diligence** - DNS records, WHOIS, open ports and tech stack of a domain you are about to buy or integrate.
- **Agent tool** - a coding or security agent calls `/api/CHECK` to inspect a URL without installing anything locally.
- **Incident triage** - quick DNS, TLS and reachability read of a failing site from outside your own network.

## Dependencies for Web-Check Hosting

- The web-check service created by the template. No volume, database or custom domain is needed.

### Deployment Dependencies

- [Web-Check repository](https://github.com/Lissy93/web-check)
- [Web-Check documentation](https://web-check.xyz)
- [Wrapper image source](https://github.com/bon5co/web-check-railway)


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/web-check-or-just-updated-website-osint-
