Jak uruchomić pierwszą aplikację z GitHuba.
Połącz GitHuba, wybierz repozytorium, zasoby i adres, a po kilku minutach aplikacja działa — pierwsza aplikacja ma 3-dniowy darmowy okres próbny.
Aplikacje uruchamiają twój własny kod — stronę, API, zadanie w tle — prosto z repozytorium Git. Nie wybierasz serwera ani pakietu hostingowego: wskazujesz repozytorium, my ustalamy, jak je zbudować i uruchomić, a każdy push sam trafia na produkcję.
Wszystko dzieje się w nowym panelu (rivervo.com/panel) → Aplikacje → Nowa aplikacja.
1. Połącz konto Git
GitHub jest dostępny zawsze. Kliknij Połącz z GitHubem: GitHub zapyta, gdzie zainstalować Rivervo (na koncie osobistym czy w organizacji) i które repozytoria może odczytywać. Do twoich repozytoriów nic nie zapisujemy.
Rivervo jest już zainstalowane na GitHubie? Użyj opcji Masz już instalację na GitHubie? Połącz ją.
GitLab i Bitbucket pojawiają się jako dodatkowe przyciski nad listą repozytoriów tam, gdzie są dostępne. Łączenie działa tak samo: zezwalasz Rivervo na odczyt repozytoriów i dodanie webhooka do automatycznych wdrożeń. Twój kod nigdy nie jest zmieniany.
2. Wybierz repozytorium
Wyszukaj repozytorium, kliknij to, które chcesz wdrożyć, a potem wybierz:
- Gałąź — gałąź, która trafia na produkcję. Każdy push do niej jest wdrażany automatycznie.
- Folder projektu — tylko dla repozytorium z kilkoma projektami (monorepo), np.
apps/web. Zostaw puste, jeśli projekt jest w katalogu głównym.
Kliknij Dalej.
Nie masz jeszcze repozytorium? Albo zacznij od szablonu tworzy na twoim koncie GitHub nowe repozytorium z jednego z naszych szablonów — Next.js, Laravel, Express, Flask albo strona statyczna. Kod należy do ciebie, a zmiany wdrażasz pushem.
3. Co wykrywamy
Odczytujemy repozytorium i ustalamy, jak je zbudować i uruchomić. Nie piszesz żadnej konfiguracji. Rozpoznajemy:
| Stos | Czego szukamy |
|---|---|
| Node.js | Next.js, Nuxt, SvelteKit, Astro, Express, Fastify, Koa, Hono, NestJS; npm, yarn lub pnpm po pliku lock |
| PHP | Laravel, Symfony, Slim, CodeIgniter lub czyste PHP (8.2–8.4) |
| Python | Django, Flask, FastAPI |
| Go | go.mod w katalogu głównym |
| Strony statyczne | czysty HTML albo build front-endu: Vite (React, Vue, Svelte), Create React App, Angular, Gatsby, Docusaurus, VitePress, statyczny eksport Next.js lub Nuxt |
Jeśli repozytorium ma własny Dockerfile, budujemy z niego bez zmian — to także sposób na uruchomienie stosu, którego nie ma na liście.
Wykryte polecenia instalacji, budowania i uruchomienia możesz później zmienić w Ustawienia → Ustawienia budowania. Wskazówki dla poszczególnych stosów: Laravel, Node.js, Next.js i Nuxt, Python, strony statyczne.
4. Zasoby i cena
Trzema suwakami wybierz tyle, ile potrzebuje aplikacja:
| Zasób | Cena | Zakres |
|---|---|---|
| Pamięć RAM | 29,53 zł za GB miesięcznie | 256 MB, 512 MB, potem pełne GB do 16 GB |
| CPU | 19,69 zł za rdzeń miesięcznie | od 1 do 8 rdzeni |
| Dysk | 10 GB w cenie na każdy GB pamięci, potem 0,74 zł za GB miesięcznie | od 5 do 500 GB, co 5 GB |
Kilka przykładów:
| Pamięć | CPU | Dysk | Miesięcznie |
|---|---|---|---|
| 512 MB | 1 rdzeń | 5 GB | 34,45 zł |
| 1 GB | 1 rdzeń | 10 GB | 49,22 zł |
| 2 GB | 2 rdzenie | 20 GB | 98,45 zł |
| 4 GB | 2 rdzenie | 60 GB | 172,29 zł |
Podczas przesuwania suwaków panel pokazuje sumę miesięczną. Zasoby możesz zmienić w każdej chwili; aplikacja zachowuje swoje dane. Każda aplikacja ma też w cenie 500 GB transferu miesięcznie na projekt — zobacz Rozliczenia aplikacji.
5. Adres
Wybierz, jak aplikacja ma być dostępna — nic nie jest zaznaczone z góry:
- Adres publiczny — dostęp z internetu pod darmowym adresem z HTTPS,
https://<name>.rivervo.app. Po uruchomieniu możesz podłączyć własną domenę — zobacz Własne domeny. - Tylko wewnętrzna — bez adresu w internecie; z aplikacją łączą się tylko inne usługi aplikacji. Dobre dla API albo backendu, który wywołuje inna usługa aplikacji — zobacz Komunikacja między usługami.
Wybierz nazwę (małe litery łacińskie, cyfry i myślniki, od 3 do 42 znaków); panel od razu powie, czy jest wolna. Później możesz przełączać się między tymi opcjami w Ustawienia → Adres publiczny.
6. Uruchomienie i darmowy okres próbny
Kliknij Uruchom i dodaj kartę. Twoja pierwsza aplikacja ma 3-dniowy darmowy okres próbny: przez te 3 dni nie pobieramy opłat z karty, a pierwszą płatność pobieramy po zakończeniu okresu próbnego. Potem aplikacja jest rozliczana co miesiąc według pokazanej ceny.
Okres próbny przysługuje raz na konto — dla pierwszej uruchomionej aplikacji.
7. Pierwsze wdrożenie
Po uruchomieniu panel na bieżąco pokazuje każdy krok: pobieranie kodu, kontrolę bezpieczeństwa, budowanie, uruchamianie i włączanie adresu. Zwykle trwa to kilka minut. Przed każdym wydaniem sprawdzamy kod pod kątem ukrytego złośliwego kodu; projekt, który go zawiera, nie zostanie zbudowany ani uruchomiony.
Po zakończeniu wdrożenia przycisk Otwórz przeniesie cię do działającej aplikacji (jeśli ma adres publiczny).
Jeśli uruchomienie się nie zakończy, panel pokaże krok i log. Usuń przyczynę w kodzie lub w Zmiennych i kliknij Spróbuj ponownie — nic więcej nie pobieramy. Wyjaśnij ten błąd krótko objaśni log i podpowie, jak to naprawić (zobacz Narzędzia dla programistów).