Najprostszy typ aplikacji w całym katalogu Saplo: zwykłe pliki HTML, CSS i JavaScript, bez żadnego buildu ani procesu trzymanego w pamięci. Jeśli masz gotową stronę - napisaną ręcznie, wyeksportowaną z generatora statycznego (Hugo, Jekyll, Eleventy, VitePress) albo kupiony gotowy szablon - po prostu wgrywasz pliki i to wszystko. Nginx serwuje je bezpośrednio, bez żadnej warstwy pośredniej, która mogłaby się wywalić.
Dla kogo jest strona statyczna na Saplo
Zanim zaczniesz instalację, sprawdź, czy to dobry wybór dla Twojego projektu:
- wizytówka albo landing z gotowego szablonu - wgrywasz pliki i strona działa, bez instalowania silnika CMS,
- strona wygenerowana przez generator statyczny - Hugo, Jekyll, Eleventy, VitePress i inne, dopóki na wyjściu zostają pliki HTML,
- dokumentacja albo portfolio - treść zmienia się rzadko, nie potrzebujesz panelu admina ani bazy danych,
- strona, którą chcesz mieć jak najlżejszą i najtrudniejszą do zepsucia - bez PHP, bez bazy MySQL, bez aktualizacji wtyczek.
Jeśli strona ma rosnąć o funkcje wymagające bazy danych albo panelu do edycji treści bez dotykania kodu, sprawdź w katalogu aplikacji WordPress albo Astro (dla treści w Markdown z repozytorium).
Wymagania
Żeby postawić stronę statyczną na Saplo, potrzebujesz:
- Boxa w dowolnym planie, S w zupełności wystarcza - to najlżejszy przepis w całym katalogu,
- minimum 64 MB wolnego RAM i 1 GB miejsca na dysku,
- domeny albo subdomeny
*.saploapp.plw cenie każdego planu, - repozytorium Git, jeśli chcesz automatycznych wdrożeń (opcjonalne, pliki możesz też wgrać przez SFTP albo archiwum
.zipprzez panel).
Instalacja krok po kroku
- W panelu Saplo wejdź w Katalog aplikacji i wybierz HTML (kategoria "Strony").
- Wskaż Box oraz nazwę aplikacji - z niej powstaje domyślna subdomena
<nazwa>.saploapp.pl. - Zatwierdź instalację. Silnik tworzy prosty placeholder
index.htmlz informacją o adresie domeny, żeby było wiadomo, że aplikacja działa, zanim wgrasz własne pliki. - Po zakończeniu instalacji domena z kroku 2 pokazuje ten placeholder - od tego momentu podmieniasz go na własną stronę.
Wgrywanie plików: SFTP albo Git
Masz dwie drogi, obie działają od razu po instalacji:
- SFTP - w panelu w sekcji Dostęp SSH / SFTP dodajesz swój klucz publiczny, dostajesz host i port do katalogu aplikacji i wgrywasz pliki dowolnym klientem (FileZilla, Cyberduck albo linią poleceń).
- Git - w szczegółach aplikacji w sekcji Git / CI-CD łączysz repozytorium, umieszczasz w nim plik
saplo.yamli wypychasz zmiany na gałąź produkcyjną. Jeśli repozytorium nie ma plikupackage.json, Saplo wgrywa pliki dokładnie tak, jak są w repo - bez żadnego builda.
Jeśli strona pochodzi z generatora statycznego, w saplo.yaml wskaż komendę builda i katalog wyjściowy:
name: moj-projekt
stack: static
build:
install: npm ci
command: npm run build
output: dist
Dla zwykłych plików HTML bez builda wystarczy:
name: moj-projekt
stack: static
build:
output: .
Strona statyczna na Saplo kontra alternatywy
| Hosting tylko-FTP | GitHub Pages | Strona statyczna na Saplo | |
|---|---|---|---|
| Wgrywanie plików | tylko FTP | tylko git push | SFTP albo git push, do wyboru |
| Własna domena | zwykle w cenie | wymaga własnej konfiguracji DNS | subdomena *.saploapp.pl gratis, własna domena od ręki |
| Generator statyczny (build) | musisz zbudować lokalnie i wgrać wynik | build przez GitHub Actions, konfigurujesz sam | build.command w saplo.yaml, Saplo buduje za Ciebie |
| Inne aplikacje obok siebie | zwykle nie | nie | tak, ten sam Box, inna aplikacja z katalogu |
Najczęstsze pytania
Czy muszę używać Gita, żeby wgrać stronę? Nie, SFTP działa od razu po instalacji - dodajesz klucz publiczny w panelu i wgrywasz pliki dowolnym klientem.
Czy strona statyczna obsłuży dowolny generator?
Tak, dopóki build wyprowadza gotowe pliki HTML do katalogu wskazanego w build.output. Sam proces builda uruchamia Saplo przy każdym git push.
Czy dostanę SSL i własną domenę?
Tak, certyfikat SSL jest automatyczny, a domenę albo subdomenę *.saploapp.pl masz w cenie każdego planu.
Ile miejsca zajmuje typowa strona wizytówkowa? Manifest przepisu podaje minimum 1 GB, co z zapasem starcza na stronę z galerią zdjęć w rozsądnej rozdzielczości.
Czy mogę później przenieść stronę na WordPressa albo Astro? Tak, to osobna aplikacja z tego samego katalogu - stawiasz ją obok, migrujesz treść we własnym tempie, a starą wersję statyczną kasujesz, gdy nowa będzie gotowa.
Strona statyczna na Saplo to najszybsza droga od pustego Boxa do działającej domeny - bez buildu, bez bazy danych, bez aktualizacji wtyczek. Jeśli treść ma z czasem rosnąć o funkcje dynamiczne, w tym samym katalogu czekają WordPress i Astro.