OpenIntegrations/docs/en/md/Addons/Melezh/Start/Installation.mdx

---
id: Installation
keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3, API, Интеграция, Сервисы, Обмен, OneScript, CLI]
title: Установка
sidebar_position: 1
---

Для начала работы с Melezh необходимо пройти процедуру его установки, после чего создать и настроить проект. В этом разделе описан процесс установки Melezh на конкретном устройстве. Выбор того или иного способа зависит от операционной системы, а также доступности в ней Docker или OneScript с пакетным менеджером OPM:

## Docker (рекомендуется)

Запустить Melezh в Docker-контейнере можно одним из следующих способов:

+ Получить образ из GHCR и запустить контейнер:

```bash
    :: Вместо -deb можно указать -rpm для использования rpm-based дистрибутива
    :: Вместо -ru можно указать -en для получения английской версии
    :: Вместо latest можно указать конкретную версию Melezh
    :: Порт может быть изменен в аргументе -p
    
    docker pull ghcr.io/bayselonarrend/melezh:latest-deb-ru
    docker run -d -p 1921:1921 --name melezh ghcr.io/bayselonarrend/melezh:latest-deb-ru
```

+ Скачать zip-архив с Dockerfile (`melezh-docker-ru.zip` или `melezh-docker-en.zip`) из релиза репозитория на Github. Архив необходимо распаковать, после чего запустить один из находящихся там скриптов установки - `bat` или `sh`, в зависимости от используемой ОС

<hr/>

## Windows

Установка Melezh на Windows осуществляется в процессе установки `oint` - основного консольного приложения Открытого пакета интеграций. Достаточно скачать установщики `oint` из релиза репозитория [OpenIntegrations](https://github.com/Bayselonarrend/OpenIntegrations) (v >= 1.24.0), после чего, в процессе установки, поставить флажок на странице с вопросом о дополнительной установке Melezh:

![Установка Melezh](../../../../static/img/Docs/Melezh/ru/1.png)

<hr/>

## Linux

Для установки Melezh на устройствах с ОС Linux, в релизах репозитория Melezh присутствуют `.deb` и `.rpm` пакеты. Оба они зависят от пакета `oint`, который в соответствующих вариантах можно найти в релизах репозитория [OpenIntegrations](https://github.com/Bayselonarrend/OpenIntegrations)

:::warning
Melezh совместим с любой версией `oint`, выше 1.24.0, но при условии совпадения языков: и Melezh, и OInt поставляются в двух языковых вариантах - русском и английском, которые нельзя смешивать друг с другом. Т.е. русская версия Melezh может быть установлена только поверх русской версии OInt, а английская - только поверх английской, соответственно
:::

<br/><hr/>

## OneScript

Melezh и OInt - это, в первую очередь, пакеты для [OneScript](https://github.com/EvilBeaver/OneScript), которые могут быть установлены при помощи пакетного менеджера OPM. Русская версия пакета может быть установлена из облачного хаба пакетов при помощи консольной команды:

```bash
opm install melezh
```

В этом пакете уже прописаны зависимости от OInt и OInt CLI - они будут установлен автоматически 

Кроме получения из облака, и английская, и русская версии могут быть установлены из локальных `.ospx` файлов пакетов, которые находятся в релизах соответствующих репозиториев [Melezh](https://github.com/Bayselonarrend/OpenIntegrations) и [OpenIntegrations](https://github.com/Bayselonarrend/OpenIntegrations):

```bash
opm install -f oint-x.x.x_lang.ospx
opm install -f oint-cli-x.x.x_lang.ospx
opm install -f melezh-x.x.x_lang.ospx
```

Как и в случае с пакетами для Linux, важно соблюдать соответствие языков версий: русская версия Melezh может работать только в зависимости от русской версии OInt, а английская - в зависимости от английской