Zum Inhalt springen
Alle Websites

Dokumentation

Installationsanleitung

  • Einmalpreis
  • Sofortige Lieferung
  • Keine Drittanbieter-Cookies

DokumentationZuletzt aktualisiert: 29.10.2026

Diese Anleitung gilt für alle Northbytra-Websites — die Website für IT-Service & Reparatur und alle Branchen-Websites. Eine Installation dauert in der Regel etwa 30 Minuten. Sie benötigen ein FTP-Programm (z. B. FileZilla) und die Zugangsdaten Ihres Hostings.

1. Das passende Paket wählen

  • Website: die Website für IT-Service & Reparatur (Computerreparatur, IT-Dienstleistungen, Videoüberwachung — mit Online-Reparaturverfolgung) oder eine Branchen-Website: Architekturbüros, Bauunternehmen, Elektrotechnik-Betriebe, Innenarchitektur-Studios, Solarteure, Möbelhäuser & Möbelhersteller, Kfz-Werkstätten, Reifenhändler, Abschleppdienste, Karosserie- & Lackierbetriebe, Autovermietungen, Autohäuser oder die Website für Ihr Unternehmen für jede andere Branche. Vergleichen Sie sie auf der Produktseite und in den Live-Demos.
  • Edition: Standard — Bestellungen per Banküberweisung, Nachnahme oder Zahlung im Geschäft. Pro — zusätzlich Online-Kartenzahlung über PayTR oder Stripe. Beide Editionen werden gleich installiert; Sie können später von Standard auf Pro wechseln, Ihr Aktivierungsschlüssel bleibt gleich.
  • Ein Paket = eine Branche: Design, Menü, Module und Beispielinhalte eines Pakets sind auf seine Branche zugeschnitten. Alle Texte, Bilder und Module lassen sich im Admin-Bereich ändern, die Branche eines Pakets kann jedoch nicht gegen eine andere getauscht werden.
  • Nach der Zahlung erhalten Sie eine E-Mail mit dem Link zu Ihrer Bestellseite: Dort zeigen Sie Ihren Aktivierungsschlüssel an und nutzen Ihren persönlichen Download-Link; nach dem Ende des Widerrufsrechts kann Ihnen zusätzlich eine Kopie des Schlüssels per E-Mail gesendet werden. Die ZIP-Datei enthält den Ordner upload und die Dokumentation (INSTALL.md / KURULUM.md).

2. Voraussetzungen

  • PHP 8.1 oder neuer mit den Erweiterungen pdo_mysql, sodium, mbstring und fileinfo (gd und intl empfohlen) — bei den meisten Hosting-Paketen Standard
  • MySQL 5.7+ oder MariaDB 10.3+
  • Apache oder LiteSpeed mit mod_rewrite — oder Nginx mit den Regeln aus Abschnitt 10
  • Ein SSL-Zertifikat für Ihre Domain (bei den meisten Anbietern kostenlos mit Let's Encrypt)

Der Einrichtungsassistent prüft alle Voraussetzungen, bevor die Installation beginnt.

3. Dateien per FTP hochladen

  1. Entpacken Sie die ZIP-Datei auf Ihrem Computer.
  2. Verbinden Sie sich per FTP — am besten per SFTP oder FTPS — mit Ihrem Hosting und laden Sie den Inhalt des Ordners upload einschließlich der versteckten .htaccess-Dateien in das Hauptverzeichnis Ihrer Domain (oft public_html, httpdocs oder htdocs).
  3. Legen Sie im Hosting-Panel eine leere MySQL-Datenbank und einen Datenbankbenutzer mit allen Rechten darauf an. Notieren Sie Datenbankname, Benutzername und Passwort.

4. Den Einrichtungsassistenten ausführen

  1. Rufen Sie Ihre Domain im Browser auf — der Assistent startet automatisch. Seine Sprache können Sie oben umschalten.
  2. Geben Sie die Datenbankzugangsdaten und Ihre Firmendaten ein.
  3. Wählen Sie die Standardsprache der Website und des Admin-Bereichs, die angebotenen Sprachen und Ihr Land / Ihre Region — Zeitzone, Währung, Telefonvorwahl und Versanddienstleister werden daraus voreingestellt.
  4. Legen Sie Ihr Admin-Konto an und geben Sie Ihren Aktivierungsschlüssel ein (siehe Abschnitt 5).
  5. Beispielinhalte: Lassen Sie das Kästchen angehakt, um mit einer vollständigen Website zu starten — Slider, Leistungen, Projekte, Produkte, Blog und FAQ in zehn Sprachen. Die Branchen-Websites enthalten echte Fotos (Pexels-Lizenz, kommerzielle Nutzung erlaubt), die IT-Website eigene Illustrationen. Jedes Element können Sie später im Admin-Bereich behalten, bearbeiten oder löschen — oder Sie entfernen den Haken und starten mit einer leeren Website.
  6. Löschen Sie nach Abschluss des Assistenten den Ordner install vom Server und bewahren Sie eine Sicherungskopie von app/config.php auf — sie enthält den Schlüssel, mit dem personenbezogene Daten verschlüsselt werden.

5. Lizenz aktivieren

  • Online-Aktivierung: Während der Installation sendet der Assistent Ihren Schlüssel, Ihre Domain und die Softwareversion an unseren Lizenzserver. Der Schlüssel ist danach an die Domain gebunden, auf der die Website installiert ist (mit oder ohne www; jede andere Subdomain benötigt eine eigene Lizenz).
  • Manueller Aktivierungscode: Kann Ihr Server keine Verbindung zum Internet aufbauen (z. B. weil eine Firewall ausgehende Verbindungen sperrt), zeigt der Assistent das Feld „Manueller Aktivierungscode“. Senden Sie uns Ihre Bestellnummer und Ihre Domain über das Kontaktformular; Sie erhalten einen Code, der nur für diesen Schlüssel und diese Domain gilt.
  • Eine Domain pro Lizenz: Jede Lizenz gilt nur für eine Domain und kann nicht auf eine andere Domain übertragen werden. Für eine weitere Website benötigen Sie eine neue Lizenz.
  • Der Aktivierungsschlüssel wird für die bei der Bestellung angegebene Domain ausgestellt und funktioniert nur dort (mit oder ohne www). Die Website kann nicht auf localhost oder anderen lokalen Adressen installiert werden — installieren Sie sie direkt auf Ihrer Domain.

6. Erste Schritte im Admin-Bereich

Melden Sie sich unter ihre-domain/admin an und arbeiten Sie die Einrichtungs-Checkliste im Dashboard ab:

  • Firmendaten (Impressum), Logo, Markenfarbe und Layout-Theme
  • Lieferoptionen und Ihre Bankverbindung für Überweisungen
  • Vorlagen der Rechtstexte — prüfen und an Ihr Unternehmen anpassen
  • Beispieltexte und -fotos durch eigene ersetzen und nicht benötigte Module abschalten

7. E-Mail (SMTP) und Zwei-Schritt-Verifizierung

  1. Öffnen Sie Website-Einstellungen → E-Mail, tragen Sie SMTP-Server, Port (587 mit STARTTLS oder 465 mit SSL), Benutzername, Passwort und Absenderadresse Ihres Postfachs ein und klicken Sie auf Test an mich senden. Gmail und Microsoft 365 benötigen ein App-Passwort. Fehlgeschlagene Zustellungen stehen mit Fehlermeldung im Versandprotokoll unter E-Mail-Benachrichtigungen.
  2. Sobald Test-E-Mails ankommen, schalten Sie unter Mein Profil die Zwei-Schritt-Verifizierung ein: Jede Anmeldung wird dann nach dem Passwort mit einem 6-stelligen Code bestätigt, der an Ihre E-Mail-Adresse geht. Bewahren Sie die zehn Wiederherstellungscodes, die nur einmal angezeigt werden, sicher auf.

8. Nur Pro: Online-Kartenzahlung

  1. Öffnen Sie Admin → Online-Zahlung, wählen Sie PayTR oder Stripe und geben Sie die API-Schlüssel aus Ihrem Anbieterkonto ein (sie werden verschlüsselt gespeichert). Lassen Sie den Testmodus vorerst eingeschaltet.
  2. PayTR: Tragen Sie die dort angezeigte Benachrichtigungs-URL in Ihrem PayTR-Händlerkonto ein. Stripe: Fügen Sie die dort angezeigte Webhook-URL hinzu und tragen Sie das Signing Secret (whsec_…) ein.
  3. Aktivieren Sie unter Lieferoptionen „Online-Kartenzahlung“ für die Optionen, bei denen Kunden per Karte zahlen dürfen.
  4. Führen Sie eine Testbestellung durch, schalten Sie dann den Testmodus aus und geben Sie Ihre Live-Schlüssel ein. Kartendaten werden nur auf der sicheren Seite des Anbieters eingegeben und erreichen Ihre Website nie.

9. Auf eine neue Version aktualisieren

Ihre Inhalte, Einstellungen, Übersetzungen, Bestellungen und Ihr Aktivierungsschlüssel sind in der Datenbank und in app/config.php gespeichert – ein Update ersetzt nur die Programmdateien. Ihre Lizenz bleibt dieselbe; eine erneute Aktivierung ist nicht nötig.

Bevor Sie beginnen

  1. Öffnen Sie im Admin-Bereich Lizenz: Die Zeile *Softwareversion* zeigt die aktuell installierte Version. Lesen Sie „Neuerungen“ in INSTALL.md / KURULUM.md des neuen Pakets.
  2. Laden Sie das neue Paket über Ihren persönlichen Download-Link herunter. Ist der Link abgelaufen, senden Sie uns Ihre Bestellnummer über das Kontaktformular und Sie erhalten einen neuen Link. Verwenden Sie immer dieselbe Website (denselben Sektor) und dieselbe Edition (Standard oder Pro) – oder das Pro-Paket für ein Upgrade von Standard auf Pro.
  3. Erstellen Sie ein Backup: Exportieren Sie die Datenbank (phpMyAdmin → Exportieren oder die Backup-Funktion Ihres Hostings) und laden Sie die Datei app/config.php sowie den Ordner uploads per FTP herunter. app/config.php enthält den Schlüssel, der personenbezogene Daten verschlüsselt – ohne ihn lassen sich diese Daten nicht mehr lesen. Noch besser ist eine vollständige Kopie des Website-Ordners.
  4. Wenn Sie Programmdateien selbst geändert haben, notieren Sie sich, welche: Die neue Version überschreibt sie, und Sie müssen Ihre Änderungen anschließend erneut vornehmen.

Aktualisierung

  1. Entpacken Sie die neue ZIP-Datei auf Ihrem Computer.
  2. Laden Sie den Inhalt des Ordners upload per FTP in denselben Ordner wie zuvor hoch und erlauben Sie dem FTP-Programm, vorhandene Dateien zu überschreiben (auch die versteckten .htaccess-Dateien). Löschen Sie vorher nichts auf dem Server. Das Paket enthält keine app/config.php und keine Ihrer Bilder, sodass Ihre Einstellungen und der Ordner uploads unverändert bleiben.
  3. Löschen Sie den Ordner install wieder vom Server.
  4. Öffnen Sie Ihre Website und melden Sie sich im Admin-Bereich an: Die Datenbank wird beim ersten Aufruf automatisch aktualisiert (das dauert einige Sekunden). Unter Lizenz wird nun die neue Versionsnummer angezeigt.

Anschließend prüfen

  • Öffnen Sie die Startseite und einige Seiten in jeder aktiven Sprache; senden Sie einmal das Kontaktformular ab.
  • Pro: Führen Sie im Testmodus Ihres Zahlungsanbieters eine Testzahlung durch oder prüfen Sie die Zahlungseinstellungen.
  • Sieht das Layout veraltet oder fehlerhaft aus? Laden Sie die Seite mit Ctrl + F5 neu und leeren Sie den Cache Ihres Hostings oder CDN (z. B. LiteSpeed Cache, Cloudflare).
  • Neue Sprachen eines Updates werden ausgeschaltet hinzugefügt – schalten Sie sie im Admin-Bereich unter Sprachen ein, wenn Sie sie nutzen möchten.

Wenn etwas schiefgeht

  • Weiße Seite oder Fehler 500: Sehen Sie sich die neueste Datei in storage/logs an – dort ist der Fehler beschrieben.
  • Um zur vorherigen Version zurückzukehren, stellen Sie sowohl die Dateien als auch die Datenbank aus Ihrem Backup wieder her. Verwenden Sie niemals alte Programmdateien mit einer bereits aktualisierten Datenbank.

10. Nginx

Apache und LiteSpeed verwenden die mitgelieferten .htaccess-Dateien. Unter Nginx fügen Sie diese Regeln in den Server-Block Ihrer Domain ein (den PHP-FPM-Socket an Ihren Server anpassen):

location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ ^/(app|storage)(/|$) { deny all; }
location ~ ^/install/(?!index\.php$).+\.php$ { deny all; }
location ~ ^/uploads/.*\.(php|phtml|phar|pl|py|cgi|sh)$ { deny all; }
location ~ /\. { deny all; }
location ~* \.(sql|md|log|lock|ini|bak|old|orig|sh|dist|env|json|yml|yaml|key|pem|zip|tar|gz)$ { deny all; }
location ~ \.php$ { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass unix:/run/php/php8.2-fpm.sock; }

11. Demo-Modus

Um die Website Kunden oder Kollegen gefahrlos vorzuführen, setzen Sie in app/config.php den Wert 'demo' => true. Besucher können dann mit einem Demo-Konto den gesamten Admin-Bereich erkunden, aber nichts wird gespeichert, die Zwei-Schritt-Verifizierung ist ausgeblendet und die Inhalte setzen sich automatisch zurück (Intervall: demo_reset_minutes). Alle Demo-Einstellungen finden Sie in der Dokumentation im Paket.

12. Fehlerbehebung

  • Alle Seiten außer der Startseite zeigen 404: Die .htaccess-Datei wurde nicht hochgeladen oder mod_rewrite ist deaktiviert.
  • Die Website leitet auf eine andere Adresse um: Korrigieren Sie base_url in app/config.php.
  • Es kommen keine E-Mails an: Prüfen Sie die SMTP-Einstellungen und lesen Sie den Fehler im Versandprotokoll.
  • Weiße Seite oder Fehler 500: Sehen Sie sich die Dateien in storage/logs an.

Probleme bei der Installation? Hilfe bei der Installation erhalten Sie über unseren kostenpflichtigen Installationsservice: Bestellen Sie ihn auf der Preisseite — oder wählen Sie ihn an der Kasse dazu — und wir installieren die Website auf Ihrem Hosting.

Noch Fragen?

Kontaktieren Sie uns