Установка и настройка Medusa.js
Medusa 2.x требует Node.js 20+, PostgreSQL 15+ и Redis 7+. Официальный CLI create-medusa-app разворачивает бэкенд и опционально Next.js Storefront и Admin Dashboard одной командой.
Быстрый старт
# Установка через официальный CLI
npx create-medusa-app@latest mystore
# Интерактивный setup спрашивает:
# - Имя проекта
# - Нужен ли Next.js Storefront
# - Нужен ли Admin Dashboard
# - Строка подключения к PostgreSQL
Ручная установка и конфигурация
mkdir mystore && cd mystore
npm init -y
npm install @medusajs/medusa @medusajs/framework
# Инициализация структуры
npx medusa new . --skip-db
# Переменные окружения
cat > .env << 'EOF'
DATABASE_URL=postgresql://medusa:password@localhost:5432/medusa_db
REDIS_URL=redis://localhost:6379
JWT_SECRET=$(openssl rand -base64 32)
COOKIE_SECRET=$(openssl rand -base64 32)
STORE_CORS=http://localhost:8000
ADMIN_CORS=http://localhost:9000
AUTH_CORS=http://localhost:9000,http://localhost:8000
EOF
# Применение миграций и seed начальных данных
npx medusa db:create
npx medusa db:migrate
npx medusa user -e [email protected] -p AdminPass123 --invite
# Запуск dev-сервера
npx medusa dev
Настройка Admin Dashboard
# Admin — отдельный Vite-проект
npm create @medusajs/admin-vite-plugin@latest medusa-admin
cd medusa-admin
npm install
npm run dev # http://localhost:9000
Сроки: базовая установка + настройка окружения + первый запуск — 2–4 часа; production-деплой с Docker и SSL — 1 день.