Files
labnethub/MACOS-SETUP.md
2026-08-03 21:02:34 +04:00

3.6 KiB

Запуск сайта LabNetHub на macOS

1. Проверьте, установлен ли Node.js

Откройте Terminal (⌘+Space → введите «Terminal» → Enter) и выполните:

node -v
npm -v
  • Если видите номер версии Node 18.17 и выше (например, v20.x) — переходите к шагу 3.
  • Если команда не найдена или версия ниже — переходите к шагу 2.

2. Установите Node.js

Вариант А — официальный установщик (самый простой):

  1. Откройте https://nodejs.org
  2. Скачайте версию LTS
  3. Запустите скачанный .pkg-файл и пройдите установку по шагам

Вариант Б — через Homebrew (если уже пользуетесь brew):

brew install node@20
brew link node@20

После установки закройте и снова откройте Terminal, затем проверьте:

node -v
npm -v

3. Распакуйте архив проекта

Дважды кликните labnethub-website.zip в Finder — рядом появится папка labnethub.

Либо через терминал:

cd ~/Downloads
unzip labnethub-website.zip
cd labnethub

4. Установите зависимости проекта

Находясь внутри папки labnethub, выполните:

npm install

Это скачает Next.js, React, Tailwind и остальные пакеты. При первом запуске занимает пару минут.

5. Настройте переменные окружения

cp .env.local.example .env.local
open -e .env.local

В открывшемся файле впишите свои значения:

TELEGRAM_BOT_TOKEN=токен_от_BotFather
TELEGRAM_CHAT_ID=ваш_chat_id

Сохраните (⌘+S) и закройте окно.

6. Запустите сайт локально

npm run dev

В терминале появится адрес — откройте в браузере:

http://localhost:3000

Чтобы остановить сервер — нажмите Control + C в терминале.

7. Проверка продакшен-сборки (по желанию)

npm run build
npm run start

Так сайт запустится в том же режиме, в котором будет работать на реальном сервере.

Частые проблемы

Проблема Решение
command not found: npm Node не установлен, либо терминал открыт до установки — закройте и откройте Terminal заново
Порт 3000 занят Next.js сам предложит другой порт, либо укажите вручную: npm run dev -- -p 3001
Ошибки при npm install Проверьте версию Node (node -v) — нужна 18.17 или выше
EACCES / ошибки прав доступа Не используйте sudo npm install — переустановите Node через официальный установщик или Homebrew

Что дальше

Инструкции по заполнению реальных контактов, деплою на сервер и настройке безопасности — в README.md в корне проекта.