Lukas/BestofSanFrancisco
Watch
1
0
Fork
You've already forked BestofSanFrancisco
 1
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
3 commits 2 branches 0 tags 109 KiB
  • HTML 88.5%
  • JavaScript 10.6%
  • Dockerfile 0.9%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
LukasGonzo 27811e431a Version 4.2
2026-10-26 19:59:36 +01:00
.vscode Version 4.2 2026-10-26 19:59:36 +01:00
.dockerignore Version 4.2 2026-10-26 19:59:36 +01:00
.env.example Version 4.2 2026-10-26 19:59:36 +01:00
.gitignore Version 2 2026-09-05 22:19:13 +02:00
.nvmrc Version 4.2 2026-10-26 19:59:36 +01:00
blog.html Version 4.2 2026-10-26 19:59:36 +01:00
docker-compose.yml Version 4.2 2026-10-26 19:59:36 +01:00
Dockerfile Version 4.2 2026-10-26 19:59:36 +01:00
farni.ng-logo.svg Version 4.2 2026-10-26 19:59:36 +01:00
index.html Version 4.2 2026-10-26 19:59:36 +01:00
Logo.jpeg Erste Version 2026-09-01 21:23:26 +02:00
package.json Version 4.2 2026-10-26 19:59:36 +01:00
README.md Version 4.2 2026-10-26 19:59:36 +01:00
schema.sql Version 4.2 2026-10-26 19:59:36 +01:00
Schirftzug.jpeg Erste Version 2026-09-01 21:23:26 +02:00
server.js Version 4.2 2026-10-26 19:59:36 +01:00

README.md

Best of San Francisco

Einrichtung mit Node.js 22

Das Projekt benötigt Node.js 22 LTS und npm 10 oder neuer. Die gewünschte Node-Version steht in .nvmrc und wird in package.json über engines geprüft.

Unter Windows Node.js 22 LTS installieren und danach ein neues PowerShell-Fenster öffnen. Anschließend im Projektordner prüfen:

node --version
npm --version

Alternativ mit nvm-windows:

nvm install 22
nvm use 22

Einrichtung mit MariaDB

Die Anwendung verbindet sich mit der externen MariaDB unter mariadb.farni.ng:3306. In .env sind Datenbankname, Benutzername und Passwort zu konfigurieren. Als Datenbankname ist zunächst bestofsf voreingestellt; falls dein Hosting-Anbieter einen anderen Datenbanknamen vergeben hat, trage diesen dort ein. Die Datenbank muss bereits beim Anbieter angelegt sein.

  1. .env.example nach .env kopieren und die MariaDB-Verbindungsdaten eintragen.

  2. Die Tabellen und Beispieldaten aus schema.sql in die beim Anbieter angelegte Datenbank importieren. Das Schema entfernt außerdem die nicht mehr benötigten Admin-Benutzer und Seitenaufrufe samt gespeicherten Passwort-Hashes. Der Datenbankbenutzer benötigt Rechte zum Löschen und Anlegen von Tabellen sowie zum Lesen und Ändern von Daten.

  3. Anwendung starten:

    docker compose up --build -d

    Die Anwendung ist anschließend unter http://localhost:3000 erreichbar. Alle dynamischen Anwendungsdaten werden auf dem externen MariaDB-Server gespeichert.

  4. Logs ansehen oder den App-Container stoppen:

    docker compose logs -f
docker compose down

    Die externe Datenbank läuft unabhängig vom App-Container weiter.

Lokaler Start ohne Docker

Nach der Datenbankeinrichtung und Konfiguration von .env kannst du die Anwendung lokal mit npm install und npm start starten. DB_HOST und DB_PORT zeigen auch dabei auf den externen MariaDB-Server.

Der Blog ist öffentlich lesbar; es gibt keine Admin-Anmeldung oder Verwaltungsseite mehr. Beiträge und Seiteneinstellungen können direkt in MariaDB gepflegt werden. In Produktion HTTPS aktivieren und NODE_ENV=production setzen.