Вступление
Начало работы
Способы установки
Облако
Самостоятельный хостинг требует больше технических навыков для настройки сервиса, резервного копирования базы данных и обслуживания обновлений. Если у вас нет опыта управления серверами и вы просто хотите использовать веб-приложение, рекомендуется воспользоваться OSMI Cloud.
Быстрый старт
Предварительное условие: убедитесь, что на вашем устройстве установлен NodeJS
Поддерживаются версии
v18.15.0 или v20 и выше.Установите OSMI локально с помощью NPM:
- Установка OSMI:
npm install -g OSMI
Вы также можете установить конкретную версию: см. доступные версии.
npm install -g OSMI@x.x.x
- Запуск OSMI:
npx OSMI start
- Открыть: http://localhost:3000
Docker
Существует два способа развернуть OSMI с помощью Docker.
Сначала клонируйте репозиторий: OSMI используя git clone
Docker Compose
- Перейдите в папку docker в корне проекта.
- Скопируйте файл
.env.exampleи сохраните копию под именем.env - Выполните команду:
docker compose up -d
- Откройте приложение в браузере на локальном порту 3000 Пример: http://localhost:3000
- Чтобы остановить контейнеры, выполните:
docker compose stop
Docker Image
- Соберите образ:
docker build --no-cache -t osmi .
- Запустите образ:
docker run -d --name osmi -p 3000:3000 osmi
- Для остановки контейнера:
docker stop osmi
Для разработчиков
OSMI состоит из 4 модулей в едином моно-репозитории:
- Server: сервер на Node.js для API логики
- UI: фронтенд на React
- Components: компоненты для интеграции
- Api Documentation: спецификация Swagger для API OSMI
Предварительное условие
Установите PNPM.
npm i -g pnpm
Настройка 1
Простая установка с использованием PNPM:
- Клонируйте репозиторий OSMI
git clone репозиторий OSMI
- Перейдите в каталог проекта
cd osmi
- Установите зависимости во всех модулях:
pnpm install
- Соберите проект:
pnpm build
Запустите приложение на локальном порту http://localhost:3000
pnpm start

