redfish

Features

What redfish gives a security team

Run a campaign, read the funnel, and train the people who clicked.

Campaigns

  • Scheduled launch

    Build a campaign and launch it now or at a set time.

  • Email templates

    Write emails in MJML and preview them before you send.

  • Landing and awareness pages

    A landing page per campaign, and an awareness page shown after a click.

Sending and targets

  • Encrypted SMTP profiles

    Each sending profile keeps its SMTP credentials encrypted at rest.

  • CSV import

    Import the people in scope from a CSV and group them into lists.

  • MJML emails

    Emails are built from MJML, so they render across mail clients.

Tracking

  • Opens and clicks

    See who opened the email and who clicked the link.

  • Reports

    Record who reported the message to their security team.

  • Scanner and bot detection

    Link scanners and bots are filtered out, so the counts reflect people.

Reports and organisations

  • Funnel per campaign

    Sent, opened, clicked and reported, read as one funnel.

  • Print and PDF

    Print a campaign report or save it as a PDF.

  • Multi-organisation

    Each organisation has its own campaigns, lists and reports.

Yours to run

  • One Docker Compose stack

    SvelteKit, a job worker and SQLite through Drizzle.

  • Retention and anonymisation

    Set how long results are kept, and anonymise them per organisation.

  • Strict CSP and host isolation

    A strict Content-Security-Policy and per-host isolation.

  • No credentials captured

    The awareness page never asks for or stores a password.

Security

Run it only where you are allowed to.

redfish is for authorized testing of your own organisation, with its written agreement. It is not for attacking anyone.

Authorized use onlyA written agreement from the organisation is required
No credentialsThe awareness page never captures a password, by design
IsolationA strict CSP and per-host isolation keep organisations apart
RetentionPer-organisation retention and anonymisation of results

What it does not do

  • Not for unauthorized use

    Use redfish only against your own organisation, with a written agreement in hand.

  • Not a password harvester

    It never captures credentials. Teaching people, not phishing them, is the point.

  • Alpha

    redfish is in alpha. Expect rough edges and breaking changes.

  • You bring the SMTP

    redfish sends through your own mail server. It is not a mail provider.

Get redfish running

One Docker Compose stack, authorized use only. Details are in the docs.

$ git clone https://github.com/selfhostr/redfish.git
$ cd redfish && cp .env.example .env
$ docker compose up -d