Jak zainstalować EmDash CMS? Instrukcja krok po kroku

Kompletna instrukcja instalacji EmDash CMS — od wymagań systemowych, przez konfigurację lokale, aż po deployment na Cloudflare Workers.

Instalacja EmDash CMS jest znacznie prostsza niż konfiguracja WordPress — nie potrzebujesz serwera, bazy MySQL ani PHP. Wystarczy Node.js i kilka komend w terminalu. W tym poradniku przeprowadzimy cię przez cały proces krok po kroku.

Wymagania systemowe

Do uruchomienia EmDash potrzebujesz: Node.js w wersji 18 lub nowszej, menedżera pakietów npm (lub pnpm/yarn) oraz terminala. Opcjonalnie — konta Cloudflare, jeśli chcesz deployować na Workers. Do pracy lokalnej konto Cloudflare nie jest wymagane — EmDash świetnie działa na zwykłym serwerze Node.js z bazą SQLite.

Instalacja lokalna

Aby stworzyć nowy projekt EmDash, uruchom w terminalu komendę: npm create emdash@latest. Kreator przeprowadzi cię przez wybór szablonu, nazwy projektu i konfiguracji. Po zakończeniu wejdź do katalogu projektu i uruchom npx emdash dev — serwer deweloperski wystartuje, zastosuje migracje bazy danych, załaduje dane startowe (seed) i wygeneruje typy TypeScript. Panel administracyjny będzie dostępny pod adresem http://localhost:4321/_emdash/admin.

Deployment na Cloudflare Workers

Najprostszy sposób to skorzystanie z przycisku Deploy to Cloudflare w repozytorium EmDash — uruchomi on cały stack jednym kliknięciem. Jeśli wolisz ręczną konfigurację, zainstaluj Wrangler CLI (npm install -g wrangler), zaloguj się do konta Cloudflare (wrangler login), a następnie uruchom npm run deploy z katalogu projektu. Wrangler automatycznie utworzy bazę D1, bucket R2 na media i wdroży aplikację na Workers. Twoja strona będzie dostępna pod adresem .workers.dev — możesz też podpiąć własną domenę w panelu Cloudflare.

Pierwsze kroki po instalacji

Po pierwszym uruchomieniu EmDash przeprowadzi cię przez tworzenie konta administratora z użyciem passkey (klucza biometrycznego lub sprzętowego — bez haseł!). Następnie możesz edytować ustawienia strony, tworzyć kolekcje treści, dodawać wpisy i strony oraz instalować wtyczki z marketplace. Plik seed/seed.json zawiera definicję schematu i przykładową treść — edytuj go, aby dostosować strukturę strony do swoich potrzeb.

Brak komentarzy