Zedmos
Installation

Zedmos auf OPNsense, AimDefense oder pfSense in etwa zehn Minuten einrichten.

Eine freundliche Anleitung für alle, die Zedmos zu Hause oder im kleinen Büro aufsetzen — ohne Netzwerk-Fachjargon, einfach die gleichen Bildschirme, die Sie sehen werden, der Reihe nach, mit ein bis zwei Sätzen Kontext zu jedem.

Übliche Dauer
~10 Minuten
Vorkenntnisse
Keine CLI-Erfahrung nötig
Was Sie brauchen
Kostenloses Konto auf console.zedmos.com + Firewall-Konsole + Browser
1
Schritt 01

Kostenloses Console-Konto anlegen

Installations-Links kommen aus Ihrem eigenen Konto auf console.zedmos.com

Die Anmeldeseite von console.zedmos.com. Der Link „Create a new Console account“ unter den Anmelde-Schaltflächen ist mit 1 markiert.

Zedmos wird mit einem kurzlebigen Installations-Link installiert, den Sie selbst erzeugen — in Ihrem eigenen Konto auf console.zedmos.com. Sie haben schon ein Konto? Melden Sie sich an und gehen Sie direkt zu Schritt 2. Sonst öffnen Sie die Seite und klicken auf Create a new Console account (1).

Das Registrierungsformular (zweites Bild) fragt nach:

  • 1 Organisation — Ihr Unternehmen bzw. der Kunde, zu dem diese Firewall gehört.
  • Full Name und 2 E-Mail — die Adresse, mit der Sie sich anmelden. Nehmen Sie eine, die Sie lesen.
  • 3 Passwort — mindestens 8 Zeichen mit Groß- und Kleinbuchstaben und einer Ziffer; die Liste unter dem Feld wird beim Tippen grün.
  • 4 Häkchen setzen: Das Konto ist für eine Organisation, und Sie akzeptieren Nutzungsbedingungen und Datenschutzhinweis.
  • 5 Register & Sign in — das Konto wird angelegt, und Sie landen auf der Startseite der Console.

Lieber kein Passwort? Google oder Microsoft unter dem Formular öffnen dasselbe Konto mit Ihrer Firmenanmeldung.

Das Registrierungsformular: Organisation (1), Full Name, E-Mail (2), Passwort (3) mit Checkliste, das Häkchen für die Bedingungen (4) und Register & Sign in (5).

Adresse
console.zedmos.com
Klicken
Create a new Console account
Tipps
  • Halten Sie diese E-Mail-Adresse bereit: In Schritt 8 verknüpft der Setup-Wizard die Firewall damit mit Ihrem Konto.
  • Die Registrierung ist kostenlos; die erste Firewall ist inklusive.
2
Schritt 02

Installations-Link erzeugen

Plattform wählen — die Console gibt Ihnen einen einzeiligen Befehl, höchstens 20 Minuten gültig

Die Startseite der Console. Die Schaltfläche + Install Link in der Fleet-Leiste ist mit 1 markiert.

Klicken Sie auf der Startseite der Console in der Fleet-Leiste auf + Install Link (1). Ein kleines Fenster öffnet sich; füllen Sie es aus, und die Console gibt Ihnen den Befehl, den Sie in Schritt 4 auf der Firewall einfügen.

Im Fenster (zweites Bild):

  • 1 Firewall-Plattform — wählen Sie, was auf der Box läuft: OPNsense, AimDefense oder pfSense. Danach richtet sich der Installer, den die Firewall herunterlädt. AimDefense nutzt dasselbe Abbild und dasselbe Paket-Repository wie OPNsense.
  • 2 Max uses — wie viele Firewalls mit diesem einen Link installieren dürfen: 1 bis 3.
  • 3 Valid for — wie viele Minuten der Link funktioniert: höchstens 20.
  • Note (optional) — eine Gedächtnisstütze wie der Name der Filiale; sie wird mit dem Link gespeichert.
  • 4 Generate.

Das Fenster zeigt jetzt den Installationsbefehl (drittes Bild, 1). Klicken Sie auf Copy (2) und halten Sie ihn bereit. Er wird nur einmal angezeigt: Nach Done lässt er sich nicht wieder aufrufen — wenn er verloren geht, erzeugen Sie einfach einen neuen Link.

Das Fenster „Generate firewall install link“: die Plattform-Kacheln OPNsense, AimDefense und pfSense (1), Max uses (2), Valid for in Minuten (3), eine optionale Notiz und Generate (4).

Der Befehl, den die Console einmal anzeigt — fetch -o - https://www.zedmos.com/install/… | sh (1) — und seine Schaltfläche Copy (2). Das Token im Bild ist ein Beispiel.

Schaltfläche
+ Install Link
Grenzen
≤ 3 Nutzungen · ≤ 20 Minuten

Der Link funktioniert nur für die eingestellten Minuten und Nutzungen — höchstens 20 Minuten und 3 Nutzungen. Erzeugen Sie ihn, wenn Sie an der Firewall-Konsole sitzen, nicht am Vortag.

Tipps
  • Mehrere Filialen auf einmal? Stellen Sie Max uses auf 2 oder 3 und führen Sie denselben Befehl innerhalb der Frist auf jeder Firewall aus.
  • „Firewall limit reached“ heißt: Die Firewall-Anzahl Ihres Tarifs ist ausgeschöpft — weitere Firewalls unter Profile → Subscriptions & Billing.
3
Schritt 03

Die OPNsense- oder pfSense-Konsole öffnen

Vom Menü in die Shell wechseln

OPNsense-Konsolenmenü mit den Optionen 0–13. Wir brauchen Option 8 (Shell). pfSense zeigt dieselbe Option 8.

Wir starten an der Firewall-Konsole — dem schwarzen Menübildschirm, den Sie sehen, wenn Sie Monitor und Tastatur an Ihre OPNsense- oder pfSense-Appliance anschließen (oder die Konsole Ihrer virtuellen Maschine öffnen). Die Screenshots stammen von OPNsense; unter pfSense gelten dieselben Schritte.

OPNsense und pfSense zeigen beide eine nummerierte Liste mit Einträgen wie Logout, Reboot system, Halt system und Shell. Wir wollen Option 8) Shell, damit wir einen einzigen Installationsbefehl ausführen können.

Tippen Sie 8 und drücken Sie Enter. Es erscheint nun ein Prompt wie root@OPNsense:~ # — oder unter pfSense [2.8.1-RELEASE][root@pfSense]/root:. Das ist die Shell — dort werden wir im nächsten Schritt den Installer einfügen.

Eingabe
8
Sie sehen
root@OPNsense:~ # · [root@pfSense]/root:
Tipps
  • Erscheint das Menü nicht? Drücken Sie einmal Enter — der Bildschirmschoner blendet es gelegentlich aus.
  • Die IP-Adressen und SSH-Fingerprints oben im Bild sind nur informativ — Sie können sie ignorieren.
4
Schritt 04

Den Installationsbefehl einfügen

Eine einzige Zeile holt den Installer von zedmos.com

Die OPNsense-Shell mit dem fetch-Befehl, der auf https://www.zedmos.com/install/<token> zeigt. Die pfSense-Shell nimmt denselben Befehl entgegen.

Fügen Sie den in Schritt 2 kopierten Befehl in die Shell ein und drücken Sie Enter.

Der Befehl sieht so aus — Ihr langes Token am Ende ist natürlich ein anderes:

$ fetch -o - https://www.zedmos.com/install/<ihr-token> | sh

Was das in einfachen Worten macht: Es lädt das Installations-Skript per HTTPS herunter und führt es sofort aus. Das Token am Ende hat Ihr Console-Konto ausgestellt: Es gilt nur für die Minuten und Nutzungen, die Sie in Schritt 2 eingestellt haben, danach ist es verbraucht. Fügen Sie es genau so ein, wie die Console es Ihnen gegeben hat.

Tipps
  • „Not found.“ heißt: Der Link ist abgelaufen oder aufgebraucht — erzeugen Sie in der Console einen neuen (Schritt 2) und fügen Sie diesen ein.
  • Vertippt? Drücken Sie einfach Enter — fetch bricht sicher ab und Sie können den Befehl erneut versuchen.
  • OPNsense und pfSense bringen beide fetch statt curl mit. Die Syntax ist ähnlich, aber nicht identisch — bitte ersetzen Sie es nicht durch curl.
5
Schritt 05

Die Installation bestätigen

Der Installer fragt einmal nach, bevor er beginnt — antworten Sie mit y

Installer-Frage unten am Bildschirm: Do you want to install the Zedmos plugin from the Zedmos repository now? [y/N]: y.

Der Installer zeigt zuerst einen kurzen Hinweis und stellt dann eine einzige Ja/Nein-Frage, bevor er Dateien kopiert. Sie können den Hinweis ruhig durchlesen — zu tun gibt es aber nur, die letzte Frage zu beantworten.

Unten am Bildschirm erscheint: „Do you want to install the Zedmos plugin from the Zedmos repository now? [y/N]”.

Tippen Sie y und drücken Sie Enter, um die Installation zu starten.

Frage
install the Zedmos plugin … now? [y/N]
Antwort
y
6
Schritt 06

Warten, bis der Installer fertig ist

Konfigurationsdateien angelegt, Anmeldung beim CTI, Agent neu gestartet

Erfolgreiches Installations-Log: policies.json, agent.json, writerd.json und zedmos_ml.json wurden angelegt; Auto-Enrollment beim öffentlichen CTI-Hub erfolgreich; Agent neu gestartet.

Der Installer kopiert das Zedmos-Paket auf Ihre OPNsense- oder pfSense-Appliance, legt ein paar sinnvolle Standard-Konfigurationsdateien an und meldet Ihre Firewall in unserem kostenlosen Threat-Intelligence-Pool an. In diesem Schritt müssen Sie nichts eingeben.

Sie sehen Zeilen wie:

  • [Zedmos] Created policies.json (fresh install) — Ihre Start-Policy-Datei.
  • [zedmos-auto-enroll] Hub minted token tier=free — Ihre Firewall ist gerade dem kostenlosen CTI-Hub beigetreten.
  • DONE — engine has CTI access (tier=free) — Installation abgeschlossen.

Sobald der Prompt zurückkommt, ist der Konsolen-Teil der Installation fertig. Sie können dieses Fenster schließen — alles Weitere passiert im Browser.

Tipps
  • Die erste Anmeldung beim Hub dauert üblicherweise 10–30 Sekunden. Bleibt „Restarting zedmos-agent…“ etwas länger stehen, ist das völlig normal.
7
Schritt 07

Den Einrichtungs-Wizard öffnen

Firewall-Menü aktualisieren, einen Zedmos-Link öffnen, Bedingungen akzeptieren

Der Zedmos Installation Wizard auf dem Welcome-Schritt — mit Checkbox für die Nutzungsbedingungen und Next-Button.

Wechseln Sie in den Browser, melden Sie sich am Webinterface der Firewall an und aktualisieren Sie das Menü. Unter OPNsense erscheint links ein neuer roter Zedmos-Eintrag; unter pfSense finden Sie Zedmos unter Services. Die Unterpunkte sind in beiden Fällen dieselben — Dashboard, Live Sessions, Policies, Settings und Feedback. Klicken Sie auf einen davon: beim ersten Aufruf öffnet sich automatisch der Einrichtungs-Wizard.

Der Welcome-Bildschirm zeigt eine kurze Zusammenfassung dessen, was der Wizard einrichtet: Datenbank, Deployment-Modus, Netzwerk-Schnittstellen und Abonnement. Rechts daneben sehen Sie ein System Overview-Panel mit Ihrer Hardware (CPU, RAM, Schnittstellen) — rein informativ, hier ist nichts auszufüllen.

Setzen Sie den Haken bei „I have read and accept the demo usage terms“ und klicken Sie unten rechts auf Next →, um zu beginnen.

Tipps
  • Kein Zedmos-Eintrag im linken Menü? Drücken Sie einmal Strg+F5 — der Menü-Cache braucht gelegentlich einen harten Reload.
8
Schritt 08

Firewall mit Ihrem Console-Konto verknüpfen

Mit dem Konto aus Schritt 1 — oder später

Der Schritt „Console Registration“ mit einem einzelnen Schalter. Der Schalter steht auf Aus — die Console-Registrierung wird übersprungen.

Dieser Schritt fügt die Firewall dem Console-Konto hinzu, das Sie in Schritt 1 angelegt haben: Sie erscheint auf der Startseite der Console, und Sie können sie von überall beobachten und verwalten.

Schalten Sie den Schalter ein und geben Sie die E-Mail-Adresse dieses Kontos ein — die, mit der Sie sich registriert haben. Die Firewall meldet sich selbst an und erscheint in Ihrer Flotte.

Möchten Sie die Firewall erst für sich allein ansehen? Lassen Sie den Schalter aus und klicken Sie auf Next →; verknüpfen können Sie später unter Settings → Console.

Tipps
  • Console ist für die erste Firewall kostenlos — die Registrierung gibt Ihnen einfach einen Ort, um Live-Flows, Geräteinformationen und Systemzustand zu sehen.
9
Schritt 09

Datenbank auswählen

SQLite ist vorausgewählt — übernehmen Sie es, außer Sie brauchen wirklich Elasticsearch

Datenbank-Auswahlbildschirm mit voreingestelltem SQLite und zwei Elasticsearch-Alternativen darunter.

Zedmos speichert Ereignisse, Flow-Daten und Auswertungen lokal auf der Firewall. In diesem Schritt entscheiden Sie, wohin.

Sie haben drei Optionen auf dem Bildschirm:

  • SQLite Database (Standard, empfohlen). Eine einzelne Datei auf der Festplatte, keine Einrichtung nötig, ideal für bis zu rund 100 Geräte im Netzwerk. Die richtige Wahl für nahezu jede Heim- und Kleinbüro-Installation.
  • Elasticsearch Local. Installiert ein lokales Elasticsearch — nützlich, wenn Sie viele Geräte haben und umfangreichere Suchmöglichkeiten wünschen.
  • Elasticsearch (entfernter Cluster). Verbindet sich mit einem bestehenden Enterprise-Elasticsearch, das Sie bereits betreiben.

Wenn Sie unsicher sind: SQLite ausgewählt lassen und auf Next → klicken.

Tipps
  • Sie können die Datenbank jederzeit später über Settings ändern — Sie müssen sich hier nicht endgültig entscheiden.
10
Schritt 10

Schnittstellen & Deployment-Modus

Der wichtigste Schritt — sagen Sie Zedmos, welchen Datenverkehr es ansehen soll

Interface-Konfiguration mit Deployment Mode = Routed, em0 in der Zone wan und em1 in der Zone lan.

Dieser Schritt hat zwei Teile: wie Zedmos im Datenpfad sitzt (Deployment-Modus) und welche Schnittstellen es beobachten soll (und was jede einzelne bedeutet).

Deployment-Modus — wählen Sie einen

  • Monitor-Modus. Zedmos beobachtet nur, es blockiert nie. Gut für einen ersten Durchlauf, wenn Sie sehen möchten, was in Ihrem Netzwerk unterwegs ist, ohne etwas zu verändern.
  • Routed-Modus (Standard). Zedmos leitet die Pakete weiter und kann schädliche blockieren. Das ist, was die meisten Heim- und Kleinbüro-Nutzer wollen — voller Schutz, volle Sichtbarkeit.
  • Bridge-Modus. Zedmos sitzt transparent zwischen zwei Netzwerkkarten (L2). Für Fortgeschrittene; nur einsetzen, wenn Sie wissen, warum Sie es brauchen.

Schnittstellen — welche sollen geschützt werden

Setzen Sie bei jeder Netzwerkkarte einen Haken, die Zedmos prüfen soll. Klicken Sie für jede auf Set Security Zone und wählen eine Zone:

  • WAN = die Seite, die zum Internet zeigt (das Kabel vom Modem / Provider).
  • LAN = Ihr vertrautes Heim- oder Büronetzwerk (PCs, Handys, Drucker, WLAN).

Eine typische Heimkonfiguration: em0 = WAN, em1 = LAN. Wählen Sie mindestens eine Schnittstelle — sonst können Sie nicht zum nächsten Schritt.

Wenn Sie Ihre Firewall ausschließlich über eine bestimmte Schnittstelle administrieren, hängen Sie keine Sperre an ihr ein, die Sie aussperren könnte. Wenn Sie das Web-UI über LAN erreichen, lassen Sie LAN angehakt — das ist der Normalfall.

Tipps
  • Sie wissen nicht, welches em# was ist? Öffnen Sie in einem zweiten Tab Interfaces → Assignments — OPNsense und pfSense haben beide diesen Punkt. Die Bezeichnungen dort entsprechen denen hier.
  • Wenn Sie ein Kabel gesteckt oder abgezogen haben, klicken Sie auf „Refresh Interfaces“, um die Liste zu aktualisieren.
11
Schritt 11

Abonnement

Free prüfen Sie am eigenen Verkehr; Licensed trägt den Schlüssel aus Ihrem Angebot

Abonnement-Schritt: Free Plan ist links ausgewählt, darunter eine Licensed-Plan-Option mit einem Eingabefeld für einen 4-Gruppen-Lizenzschlüssel.

Wählen Sie die Lizenz, unter der diese Firewall läuft. Free ist vorausgewählt und bietet dreißig Tage lang alle Funktionen auf bis zu drei Firewalls; Licensed übernimmt den Schlüssel aus Ihrem Angebot.

  • Free (vorausgewählt). Alle Funktionen, bis zu drei Firewalls, eine Organisation, dreißig Tage lang — geprüft am eigenen Verkehr statt an einem Demo-Datensatz. Die Firewall wird automatisch in den öffentlichen Threat-Intelligence-Pool aufgenommen. Hier ist nichts einzutippen.
  • Licensed. Tragen Sie den 16-stelligen Schlüssel ein, der zu Ihrem Team- oder MSP-Abonnement ausgestellt wurde. Schlüssel werden gegen ein Angebot ausgestellt, das Stufe, Firewall-Anzahl und Laufzeit benennt — was die Stufen abdecken, steht unter Wie die Lizenzierung funktioniert.

Klicken Sie auf Next → mit ausgewähltem Free Plan.

Lassen Sie Free ausgewählt, sofern Sie nicht bereits einen Lizenzschlüssel besitzen. Das Licensed-Feld erwartet einen von Zedmos ausgestellten Schlüssel — der Wizard kann keinen erzeugen, und ein leerer oder erfundener Schlüssel scheitert an der Prüfung. Angebot und Schlüssel kommen über sales@zedmos.com.

Tipps
  • Auf der Firewall läuft nichts ab. Endet der freie Zeitraum, wird die Konsole schreibgeschützt — Sie ändern nichts mehr, die Firewall setzt ihre Richtlinie weiter durch, und es wird nichts gelöscht. Einen Schlüssel tragen Sie später unter Einstellungen → License ein und drücken Activate; keine Neuinstallation.
12
Schritt 12

Speichern & Anwenden — Engine starten

Ein letzter Klick und Zedmos läuft

„Configuration Complete“-Bildschirm mit grüner Bestätigung „Thank you for choosing Zedmos“ und Save-&-Apply-Button.

Geschafft. Der letzte Bildschirm bestätigt, dass Ihre Konfiguration bereit ist. Bleibt nur, sie anzuwenden.

Rechts sehen Sie ein What's Next?-Panel mit Verweisen auf Dashboard, Policies, Devices und Settings — dort werden Sie nach der Installation Ihre Zeit verbringen.

Klicken Sie auf den großen grünen Save & Apply Configuration-Button. Zedmos schreibt Ihre Entscheidungen auf die Festplatte, startet die Engine, und der Wizard schließt sich. Nach wenigen Sekunden zeigt ein Reload der Seite das Live-Dashboard.

Letzter Klick
Save & Apply Configuration
Ergebnis
Engine läuft, Dashboard gefüllt
Geschafft

Willkommen bei Zedmos — danke, dass Sie es installiert haben.

Ab hier hat jede Seite im Zedmos-Menü ihre eigene Hilfeansicht mit ausführlichen Beispielen — Sie müssen sich aus dieser Anleitung also nichts merken. Hier ein kurzer Überblick, wo Sie zuerst hinschauen.

Dashboard

Live-Datenverkehr, aktivste Geräte und Sicherheitsereignisse auf einen Blick. Die Seite, die Sie täglich als Erstes öffnen werden.

Live Sessions

Sehen Sie genau die Verbindungen, die gerade in Ihrem Netzwerk laufen — praktisch, wenn etwas langsam wirkt und Sie wissen wollen, warum.

Policies

Erlauben/Blockieren-Regeln und Threat-Intelligence-Kategorien. Jede Seite erklärt, was jeder Schalter bewirkt.

Reports

Historische Auswertungen — was gestern, letzte Woche, letzten Monat passiert ist. Gut, um Trends zu erkennen und zu zeigen, was Zedmos abgefangen hat.

Settings

Erweiterte Optionen: Console-Anmeldung, TLS-Inspection, Lizenz, Integrationen. Die Standardwerte sind sinnvoll — ändern Sie nur, was Sie wirklich brauchen.

Hilfe (auf jeder Seite)

Achten Sie auf das kleine „?“-Panel rechts auf jeder Seite. Es enthält dieselben freundlichen Erklärungen, die Sie in dieser Anleitung gesehen haben.

Irgendwo hängengeblieben? Eine E-Mail genügt.

Schreiben Sie jederzeit an support@zedmos.com — keine Frage ist zu klein. Wir lesen jede Nachricht und antworten selbst.

Vielen Dank, dass Sie sich für Zedmos entschieden haben. Wir haben es so gebaut, wie wir uns selbst eine Firewall im eigenen Zuhause wünschen würden — sicher, transparent und freundlich zu den Menschen, die sie benutzen.