Як запустити перший застосунок із GitHub.
Підключіть GitHub, виберіть репозиторій, ресурси й адресу — і за кілька хвилин застосунок уже працює. Для першого застосунку — 3 дні безкоштовно.
Застосунки запускають ваш власний код — сайт, API, фонове завдання — прямо з Git-репозиторію. Вам не потрібно вибирати сервер чи тариф хостингу: ви вибираєте репозиторій, ми самі визначаємо, як його зібрати й запустити, а кожен push потрапляє в робочу версію автоматично.
Усе відбувається в новій панелі (rivervo.com/panel) → Застосунки → Новий застосунок.
1. Підключіть свій Git-акаунт
GitHub доступний завжди. Натисніть Підключити GitHub: GitHub запитає, куди встановити Rivervo (в особистий акаунт чи в організацію) і які репозиторії йому дозволено читати. У ваші репозиторії нічого не записується.
Уже встановлювали Rivervo на GitHub раніше? Скористайтеся кнопкою Уже встановили на GitHub? Прив’яжіть.
GitLab і Bitbucket з’являються як додаткові кнопки над списком репозиторіїв там, де вони доступні. Підключаються вони так само: ви дозволяєте Rivervo читати ваші репозиторії й додати вебхук для автоматичних розгортань. Ваш код ніколи не змінюється.
2. Виберіть репозиторій
Знайдіть потрібний репозиторій пошуком, натисніть на нього, а потім виберіть:
- Гілка — гілка, яка йде в робочу версію. Кожен push у неї розгортається автоматично.
- Папка проєкту — лише для репозиторію з кількома проєктами (монорепозиторію), наприклад
apps/web. Якщо проєкт лежить у корені, залиште поле порожнім.
Натисніть Продовжити.
Репозиторію ще немає? Або почніть із шаблону створює новий репозиторій у вашому акаунті GitHub з одного з наших шаблонів — Next.js, Laravel, Express, Flask або статичний сайт. Код належить вам, а зміни ви розгортаєте через push.
3. Що ми визначаємо
Ми читаємо репозиторій і визначаємо, як його зібрати й запустити. Жодних конфігураційних файлів писати не потрібно. Ми розпізнаємо:
| Стек | На що дивимося |
|---|---|
| Node.js | Next.js, Nuxt, SvelteKit, Astro, Express, Fastify, Koa, Hono, NestJS; npm, yarn або pnpm — за lock-файлом |
| PHP | Laravel, Symfony, Slim, CodeIgniter або чистий PHP (8.2–8.4) |
| Python | Django, Flask, FastAPI |
| Go | go.mod у корені |
| Статичні сайти | чистий HTML або збирання фронтенду: Vite (React, Vue, Svelte), Create React App, Angular, Gatsby, Docusaurus, VitePress, статичний експорт Next.js чи Nuxt |
Якщо в репозиторії є власний Dockerfile, ми збираємо за ним як є — так само можна запустити стек, якого немає в списку.
Визначені команди встановлення, збирання й запуску можна змінити пізніше в Налаштуваннях → Налаштування збирання. Поради для кожного стеку: Laravel, Node.js, Next.js і Nuxt, Python, статичні сайти.
4. Ресурси й ціна
Виберіть стільки ресурсів, скільки потрібно вашому застосунку, за допомогою трьох повзунків:
| Ресурс | Ціна | Діапазон |
|---|---|---|
| Пам’ять | 326,41 ₴ за ГБ на місяць | 256 МБ, 512 МБ, далі цілими ГБ до 16 ГБ |
| CPU | 217,61 ₴ за ядро на місяць | від 1 до 8 ядер |
| Диск | 10 ГБ включено на кожен ГБ пам’яті, далі 8,16 ₴ за ГБ на місяць | від 5 до 500 ГБ із кроком 5 ГБ |
Кілька прикладів:
| Пам’ять | CPU | Диск | На місяць |
|---|---|---|---|
| 512 МБ | 1 ядро | 5 ГБ | 380,82 ₴ |
| 1 ГБ | 1 ядро | 10 ГБ | 544,02 ₴ |
| 2 ГБ | 2 ядра | 20 ГБ | 1 088,05 ₴ |
| 4 ГБ | 2 ядра | 60 ГБ | 1 904,09 ₴ |
Поки ви рухаєте повзунки, панель показує підсумок за місяць. Ресурси можна змінити будь-коли пізніше — дані застосунку зберігаються. Кожен застосунок також включає 500 ГБ трафіку на місяць на проєкт — див. Оплата застосунків.
5. Адреса
Виберіть, як буде доступний застосунок, — заздалегідь нічого не вибрано:
- Публічна адреса — доступ з інтернету за безкоштовною адресою з HTTPS,
https://<name>.rivervo.app. Після запуску можна підключити власний домен — див. Власні домени. - Лише внутрішній — адреси в інтернеті немає; до застосунку звертаються лише інші сервіси застосунку. Підходить для API чи бекенду, який викликає інший сервіс застосунку, — див. Зв’язок між сервісами.
Виберіть назву (малі латинські літери, цифри й дефіси, від 3 до 42 символів); панель одразу скаже, чи вона вільна. Перемикатися між цими варіантами можна й пізніше в Налаштуваннях → Публічна адреса.
6. Запуск — і безкоштовний пробний період
Натисніть Запустити й додайте картку. Для першого застосунку діє безкоштовний пробний період на 3 дні: протягом цих 3 днів кошти з картки не списуються, а перший платіж знімається, коли пробний період закінчується. Далі застосунок оплачується щомісяця за показаною ціною.
Пробний період надається один раз на акаунт — для першого застосунку, який ви запускаєте.
7. Перше розгортання
Після запуску панель у реальному часі показує кожен крок: отримання коду, перевірку безпеки, збирання, запуск і ввімкнення адреси. Зазвичай це займає кілька хвилин. Перед кожним релізом ми перевіряємо код на прихований шкідливий код; проєкт, у якому його знайдено, не збирається й не запускається.
Коли розгортання завершиться, кнопка Відкрити перенесе вас до вашого працюючого застосунку (для застосунку з публічною адресою).
Якщо запуск не завершився, панель покаже крок і журнал. Виправте причину у своєму коді чи у Змінних і натисніть Спробувати ще раз — нічого додатково не списується. Пояснити помилку коротко пояснить журнал і підкаже, як виправити проблему (див. Інструменти розробника).