Як розгорнути проєкт Bolt.new на власному сервері

Щоб розгорнути проєкт Bolt.new на власному сервері, підключіть проєкт до GitHub або завантажте його як zip, передайте код панелі Coolify на сервері, задайте змінні середовища й спрямуйте на нього домен. Документація Bolt каже те саме: коли код на GitHub, публікувати можна через інший обраний вами сервіс. Якщо йдете через GitHub, можете й далі працювати в Bolt, а ваші зміни потраплятимуть у репозиторій самі.

Bolt зосереджений на JavaScript. Його підтримуваний стек — Node.js на бекенді та браузерні фреймворки на фронтенді, без бекендів на Python чи PHP. Тож ваш проєкт, найімовірніше, звичайний проєкт Node із package.json, і для запуску йому не потрібне нічого специфічного для Bolt.

Як забрати код із Bolt?

Через GitHub

1. Відкрийте проєкт, натисніть значок GitHub угорі праворуч, увійдіть у свій обліковий запис GitHub і надайте доступ, який він просить.
2. Назвіть репозиторій і натисніть Create repository.
3. Репозиторій створюється приватним із гілкою main. Відтоді Bolt надсилає в нього кожну зміну.

Як zip

Натисніть назву проєкту вгорі ліворуч, потім Download. Zip — це одноразова копія, яка не підхоплює подальших змін у Bolt. Сервер розгортає з репозиторію Git, тож код усе одно доведеться в нього покласти. Розпакувати його й виконати npm install && npm run dev — швидкий спосіб побачити, як код працює поза Bolt.

Який це проєкт?

Налаштування визначає проєкт, тож перевірте залежності в package.json. Рядки Next.js, Vite і Astro — це налаштування, які ми випробували з Coolify на справжньому сервері.

Якщо проєкт Vite маршрутизує сторінки в браузері, задайте для Site type значення SPA на сторінці General. Якщо цього не зробити, вкладена сторінка зазвичай повертає 404 після оновлення.

Крок за кроком

1. Замовте сервер на сторінці Next.js VPS. До цього варіанта входить Coolify, тож розгортати можна з тієї самої панелі, навіть якщо ваш проєкт не на Next.js.
2. Клонуйте репозиторій і виконайте npm run build. Код, що працює в попередньому перегляді Bolt, усе одно може не пройти робочу збірку, і краще дізнатися про це раніше за сервер.
3. Відкрийте теку в інструменті для кодування, як-от Claude Code чи Cursor. Скопіюйте рядок Вставте у свій інструмент ШІ з вкладки Огляд своєї панелі Seturack і вставте його. Інструмент прочитає інструкції та розгорне, додавши ключ розгортання лише для читання до приватного репозиторію.
4. Дайте йому змінні середовища, яких очікує ваш код, а самі значення тримайте поза кодом.
5. Коли з’явиться адреса HTTPS, перевірте сторінки, вхід і запис даних.
6. Спрямуйте запис A на IP-адресу сервера й повідомте інструменту доменне ім’я. Сертифікат випускається автоматично.

Усе це можна зробити й вручну в Coolify, як пояснює наш посібник із Next.js. Root-доступ у вас є, і якщо хочете, усім можна керувати з панелі.

Не пускайте в роботу кожну зміну

Ось деталь, характерна для Bolt. Оскільки він надсилає кожну зміну в репозиторій, вебхук на main означає, що кожен запит запускає нову збірку, а недороблені експерименти потрапляють у роботу. Щоб цього уникнути, натисніть значок GitHub, скористайтеся Create new branch, щоб працювати в окремій гілці, і зливайте в main, коли закінчите. Сервер стежить лише за main, тож відвідувачі бачать завершену версію.

Що буде з Bolt Database?

Bolt Database зберігає ваші дані, вхід, файлове сховище та серверні функції в Bolt Cloud. Перенесення коду залишає все це на місці, тож ви обираєте, що буде далі.

Ключі на сторінці Secrets у Bolt призначені для його серверних функцій. Код, що працює на вашому сервері, читає їх зі змінних середовища, тож вводите їх туди самі.

Поширені запитання

Наскільки потужний сервер потрібен проєкту Bolt.new?

Сторінка продажу радить щонайменше 4 ГБ RAM, 2 vCore і 40 ГБ диска. Збірки Next.js вимагають дедалі більше пам’яті, коли проєкт росте: проєкт із 85 пакетами не зібрався на 2 ГБ, а на 4 ГБ зібрався, тоді як малий пройшов на 2 ГБ. Якщо цього замало, збільште сервер у панелі.

Скільки це коштуватиме на місяць?

Рекомендований мінімальний розмір коштує близько $6 на місяць (ПДВ включено), а за межами Туреччини ви платите в доларах США. Щоденні резервні копії входять у ціну, а трафік необмежений. Підписка на Bolt — окрема, і вона триває, якщо ви продовжуєте розробку там.

Як підключити свій домен?

Спрямуйте запис A на IP-адресу сервера, додайте домен до застосунку й розгорніть знову. Сертифікат випускається автоматично. Запис описано в нашій довідковій статті.

Як зміна в Bolt потрапляє на сервер?

Bolt надсилає її на GitHub, а з вебхуком сервер перебудовує проєкт після кожного push у гілку, за якою стежить. Без нього натисніть Redeploy у Coolify.

Чи можна перенести базу даних на PostgreSQL у Coolify?

Якщо ваш код звертається до бази даних безпосередньо через SQL, так. Bolt Database також охоплює вхід, файли та серверні функції, і звичайний PostgreSQL їх не замінить, якщо ваш код від них залежить. У такому разі шлях через Supabase потребує менше змін у коді.

Готове до роботи в Seturack: Next.js, Coolify, Supabase.