Docker Compose установка Pepeunit

INFO

Данное руководство для debian 12, но подойдёт почти для всех unix систем.

WARNING

Если сомневаетесь, спросите для вашей платформы у доступной вам LLM, следующий промт:

text

Напиши гайд как установить docker и docker compose на машину <Название дистрибутива>

Установка Docker

Данный набор команд позволит установить Docker в систему для пользователя root:

bash

sudo su
curl -fsSL https://get.docker.com -o get-docker.sh
sh ./get-docker.sh

Проверьте установку Docker:

bash

docker --version
docker run hello-world

Если права для использования команды docker нужно предоставить другому пользователю - можно воспользоваться командой:

bash

sudo su
sudo usermod -aG docker <user-name>

Установите docker в автозапуск:

bash

sudo systemctl start docker
sudo systemctl enable docker

Установка Docker Compose

Выполните команды:

bash

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Проверьте установку Docker Compose:

bash

docker-compose --version

Репозиторий Pepeunit Deploy

Хранит в себе все файлы и примеры нужные для запуска инстанса Pepeunit при помощи docker compose, чтобы склонировать репозиторий выполните команды:

bash

git clone https://git.pepemoss.com/pepe/pepeunit/pepeunit_deploy.git
cd pepeunit_deploy

Заполняем первичный .env файл

На выбор есть два варианта установки:

Для локального использования на основе .env.local.example
Для глобального использования на основе .env.global.example

Отличие состоит в том, что локальный рассчитан на эксплуатацию в локальной сети, а глобальный позволяет обращаться к инстансу Pepeunit по доменному имени через https.

Выберите один из файлов и уберите у него приставку .example

.env.local.example -> .env.local
.env.global.example -> .env.global

Например командой:

bash

mv .env.local.example .env.local

В файлах .env.local и .env.global используется уменьшенное число переменных окружения, т.к. на его основе генирируются файлы для всех docker compose сервисов:

Переменная	Пример для `.env.local`	Пример для `.env.global`	Зачем нужна?
`POSTGRES_USER`	`pepeunit-admin`	`pepeunit-admin`	Имя пользователя, от имени которого будет создана база данных
`POSTGRES_PASSWORD`	`f6prBUMbhvNnlLZ0f0HN`	`f6prBUMbhvNnlLZ0f0HN`	Пароль пользователя, от имени которого будет создана база данных
`POSTGRES_DB`	`pepeunit-db`	`pepeunit-db`	Название базы данных
`CLICKHOUSE_USER`	`pepeunit-admin`	`pepeunit-admin`	Имя пользователя, от имени которого будет создана база данных
`CLICKHOUSE_PASSWORD`	`f6prBUMbhvNnlLZ0f0HN`	`f6prBUMbhvNnlLZ0f0HN`	Пароль пользователя, от имени которого будет создана база данных
`CLICKHOUSE_DB`	`default`	`default`	Название базы данных
`BACKEND_DOMAIN`	`192.168.0.22`	`unit.pepeunit.com`	Доменное имя от инстанса Pepeunit
`BACKEND_SECURE`	`False`	-	Выбирает `http` или `https` для `BACKEND_DOMAIN` инстанса Pepeunit, по умолчанию `https`
`TELEGRAM_TOKEN`	`1111111111:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA`	`1111111111:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA`	Токен `Telegram Bot` можно получить у Bot Father
`TELEGRAM_BOT_LINK`	`https://t.me/PepeUnitRobot`	`https://t.me/PepeUnitRobot`	Ccылка на бота, которого вы создаёте в Bot Father
`MQTT_HOST`	`192.168.0.22`	`emqx.pepeunit.com`	Доменное имя от инстансa EMQX MQTT Broker
`MQTT_SECURE`	`False`	-	Выбирает `http` или `https` для `MQTT_HOST` инстансa Pepeunit, по умолчанию `https`
`MQTT_USERNAME`	`YabJTlmvQ4tvweuTl0gn`	`YabJTlmvQ4tvweuTl0gn`	Имя администратора EMQX MQTT Broker
`MQTT_PASSWORD`	`F2qvym9lxL0DK6DlhmN1HgczWe9lKj30BvJTyvHu`	`F2qvym9lxL0DK6DlhmN1HgczWe9lKj30BvJTyvHu`	Пароль администратора EMQX MQTT Broker
`GF_USER`	`admin`	`admin`	Логин админа для Grafana
`GF_PASSWORD`	`aN4bzmwMjB0v69LPvxpLLJ7LHXTe6hlqZ703mVmB`	`aN4bzmwMjB0v69LPvxpLLJ7LHXTe6hlqZ703mVmB`	Пароль админа для Grafana

Генерация env/.env.service

Выполните команду генерирующую итоговые .env.service файлы в дирректории env/.env.service:

bash

$> python make_env.py
2025-09-16 00:51:44,693 - INFO - Run make envs
2025-09-16 00:51:44,693 - INFO - Run search .env.local or .env.global
2025-09-16 00:51:44,693 - INFO - The .env.global file was found
2025-09-16 00:51:44,693 - INFO - Load variables from .env.global
2025-09-16 00:51:44,694 - INFO - Generate .env.emqx
2025-09-16 00:51:44,694 - INFO - Save env/.env.emqx
2025-09-16 00:51:44,694 - INFO - Generate .env.postgres
2025-09-16 00:51:44,694 - INFO - Save env/.env.postgres
2025-09-16 00:51:44,694 - INFO - Generate .env.frontend
2025-09-16 00:51:44,694 - INFO - Save env/.env.frontend
2025-09-16 00:51:44,694 - INFO - Generate .env.backend
2025-09-16 00:51:44,694 - INFO - Existing .env.backend found, loading sensitive keys
2025-09-16 00:51:44,695 - INFO - Load variables from env/.env.backend
2025-09-16 00:51:44,695 - INFO - Save env/.env.backend
2025-09-16 00:51:44,695 - INFO - Generate .env.grafana
2025-09-16 00:51:44,695 - INFO - Save env/.env.grafana
2025-09-16 00:51:44,695 - INFO - Generate .env.clickhouse
2025-09-16 00:51:44,695 - INFO - Save env/.env.clickhouse
2025-09-16 00:51:44,696 - INFO - Generate .env.backend_data_pipe
2025-09-16 00:51:44,696 - INFO - Existing .env.backend found, loading sensitive keys
2025-09-16 00:51:44,696 - INFO - Load variables from env/.env.backend
2025-09-16 00:51:44,696 - INFO - Save env/.env.backend_data_pipe
2025-09-16 00:51:44,696 - INFO - Generate grafana.ini
2025-09-16 00:51:44,696 - INFO - Environment file generation is complete

DANGER

Команда python3 make_env.py каждый раз перегенерирует конфиги. При перегенерации существующие секретные 32 битные ключи не измененяются. Используйте команды создания backup, для сохранения старой конфигурации.

DANGER

Вам может потребоваться внести изменения в конфигурацию отдельных сервисов для тонкой настройки. Подробнее о переменных окружения Backend, Backend Data Pipe и Frontend

Настройка Nginx

Обычно настройка Nginx для docker compose не требуется. Если ваш инстанс Pepeunit будет находиться за ещё одним Nginx, используйте подробную настройку: Подробная настройка nginx для https и reverse proxy

Открытие портов

Для корректной работы Pepeunit, нужно открыть следующие порты:

80 - для работы по http
443 - для работы по https
1883 - для работы по протоколу MQTT

WARNING

если ваш 1883 порт занят другими приложениями, изменить его на другой и внесите изменения в ENV переменные Backend - MQTT_PORT, а также в docker-compose.yml в секцию emqx.ports - значение - "1883:1883" вам нужно будет заменить например на: - "1885:1883"

DANGER

Если у вас публичный инстанс Pepeunit с доменом - вам потребуется прокинуть данные порты наружу

Первый запуск

Настройте доступ для volumes:

bash

sudo chmod 777 -R data

Выполните команду запуска Pepeunit:

bash

docker compose up

INFO

Пример корреткного запуска Backend на основе конфига .env.global. Для .env.local будут отличаться только ip адреса и установка pooling для Telegram Bot:

bash

$> docker logs -f backend
Wait Ready PostgreSQL...
postgres:5432 - accepting connections
PostgreSQL available.
Wait check DB 'pepeunit'...
DB 'pepeunit' Exist.
Fix collation postgres for swap version containers
NOTICE:  version has not changed
ALTER DATABASE
Collation fixed.
Run migration...
INFO  [alembic.runtime.migration] Context impl PostgresqlImpl.
INFO  [alembic.runtime.migration] Will assume transactional DDL.
Del old lock files
[2025-09-15 22:09:28 +0000] [42] [INFO] Starting gunicorn 23.0.0
[2025-09-15 22:09:28 +0000] [42] [INFO] Listening at: http://0.0.0.0:5000 (42)
[2025-09-15 22:09:28 +0000] [42] [INFO] Using worker: uvicorn.workers.UvicornWorker
[2025-09-15 22:09:28 +0000] [43] [INFO] Booting worker with pid: 43
[2025-09-15 22:09:28 +0000] [44] [INFO] Booting worker with pid: 44
[2025-09-15 22:09:33 +0000] [44] [INFO] on_connect handler accepted
[2025-09-15 22:09:33 +0000] [44] [INFO] on_message handler accepted
[2025-09-15 22:09:33 +0000] [43] [INFO] on_connect handler accepted
[2025-09-15 22:09:33 +0000] [43] [INFO] on_message handler accepted
[2025-09-15 22:09:33 +0000] [44] [INFO] Started server process [44]
[2025-09-15 22:09:33 +0000] [44] [INFO] Waiting for application startup.
INFO - 2025-09-15 22:09:33,442 - Total migrations to apply: 0
INFO - 2025-09-15 22:09:33,443 - Check state EMQX Broker https://dcemqx.pepemoss.com
[2025-09-15 22:09:33 +0000] [43] [INFO] Started server process [43]
[2025-09-15 22:09:33 +0000] [43] [INFO] Waiting for application startup.
INFO - 2025-09-15 22:09:33,671 - HTTP Request: GET https://dcemqx.pepemoss.com/api-docs/swagger.json "HTTP/1.1 200 OK"
INFO - 2025-09-15 22:09:34,803 - EMQX Broker https://dcemqx.pepemoss.com - Ready to work
INFO - 2025-09-15 22:09:34,850 - HTTP Request: POST https://dcemqx.pepemoss.com/api/v5/login "HTTP/1.1 200 OK"
INFO - 2025-09-15 22:09:34,851 - Del file auth hook MQTT Broker
INFO - 2025-09-15 22:09:34,923 - HTTP Request: DELETE https://dcemqx.pepemoss.com/api/v5/authorization/sources/file "HTTP/1.1 204 No Content"
INFO - 2025-09-15 22:09:34,923 - Del http auth hook MQTT Broker
INFO - 2025-09-15 22:09:34,987 - HTTP Request: DELETE https://dcemqx.pepemoss.com/api/v5/authorization/sources/http "HTTP/1.1 204 No Content"
INFO - 2025-09-15 22:09:34,988 - Del redis auth hook MQTT Broker
INFO - 2025-09-15 22:09:35,057 - HTTP Request: DELETE https://dcemqx.pepemoss.com/api/v5/authorization/sources/redis "HTTP/1.1 204 No Content"
INFO - 2025-09-15 22:09:35,058 - Set ACL file auth hook MQTT Broker
INFO - 2025-09-15 22:09:35,100 - HTTP Request: POST https://dcemqx.pepemoss.com/api/v5/authorization/sources "HTTP/1.1 204 No Content"
INFO - 2025-09-15 22:09:35,101 - Set http auth hook MQTT Broker
INFO - 2025-09-15 22:09:35,315 - HTTP Request: POST https://dcemqx.pepemoss.com/api/v5/authorization/sources "HTTP/1.1 204 No Content"
INFO - 2025-09-15 22:09:35,315 - Set redis auth hook MQTT Broker
INFO - 2025-09-15 22:09:35,492 - HTTP Request: POST https://dcemqx.pepemoss.com/api/v5/authorization/sources "HTTP/1.1 204 No Content"
INFO - 2025-09-15 22:09:35,492 - Set cache settings auth hook MQTT Broker
INFO - 2025-09-15 22:09:35,608 - HTTP Request: PUT https://dcemqx.pepemoss.com/api/v5/authorization/settings "HTTP/1.1 200 OK"
INFO - 2025-09-15 22:09:35,609 - Set settings for tcp listener
INFO - 2025-09-15 22:09:35,705 - HTTP Request: PUT https://dcemqx.pepemoss.com/api/v5/listeners/tcp:default "HTTP/1.1 200 OK"
INFO - 2025-09-15 22:09:35,706 - Set global mqtt settings
INFO - 2025-09-15 22:09:35,749 - HTTP Request: PUT https://dcemqx.pepemoss.com/api/v5/configs/global_zone "HTTP/1.1 200 OK"
INFO - 2025-09-15 22:09:35,750 - Disable retainer
INFO - 2025-09-15 22:09:35,803 - HTTP Request: PUT https://dcemqx.pepemoss.com/api/v5/mqtt/retainer "HTTP/1.1 200 OK"
INFO - 2025-09-15 22:09:35,810 - Run sync all repository in RepositoryRegistry
INFO - 2025-09-15 22:09:35,871 - End sync all repository in RepositoryRegistry
INFO - 2025-09-15 22:09:35,872 - 
            
                           ........:                                   
                          :......::-                                   
                           .....::.:                                   
                           .....::.-                                   
                      :.........::.-****                               
                    :........::::--==++###%                            
                  :::-++*++=======++*#@@%%-::                          
                ....:-=---==++******###%%*-...:                        
              :....:--===++=*=+**%@@%@%%%%*+:..:                       
            :....::=====+====+==*##%@%%%#*##+=...:                     
          -...........:-===++*=++**#%*:....::---...:                   
         :......-..:*##%%*+++===+#*-.:-..+#%%%#*+:...:                 
       :......=..++*##%%%%#**++--=..-.--*##%%*%@#+=....-               
      :..:-:.+-+=+#%%***+#@#*=---..+:=**+%@%%*%@@*+=-...:              
     =--===-.%%=#*#%-.=:+@@%**==-::%%#==#@@#%@@+@%**+=:::              
     =-=====.+@%%+@@%:.-#@@##***+-:%@%*%@%@%%=%@@#++::-::              
     =--====-.#@@*@+@@*@@@#***#**#-:%@*%%+@=@*@@#*==-..::              
     ==+*=+++=::#@@@@@@@########*#%==+%@@@@@@@#**++++*+::-             
     *@*+++++++++****#####%##%###%#%%%%#########*##+==*#--             
     -*@%**==+=+*#=+**###%%%%####%%##%%%%%%%#%%%#####@@%=+             
  :::-=--+%%@*##*.-.*#####%%%########%%%%%%%###%%@@%*++=+****          
  ....:---------==***#%%%%%*%#%%#%%%%%%%%%#*++=====+**#######%         
  ....:-:::-=====-----------------------===+++***+++*#%@@%###%         
  :--=:=++++====---::::---------===========++*##%@@@@@@@@@@@@@         
     =--+*++++***+=+*****###########%%%%%%%%%#%%%#@@@@@@@@             
       +==++++**+...:*=+=*=+==*++##++=+++#%-:-*%#%@@@@@@               
          %#*****#####*##*-+-=*==#--+#**%*%%%%@@@@@@@                  
            *##%@@@@@@@%%%%%%%%%%%%%%@@@@@@@@@@@@@@                    
            *###%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@                    
                %%@@@@@@@@@@@@@@@@@@@@@@@@@@@@       
             _____                            _ _   
            |  __ \                          (_) |  
            | |__) |__ _ __   ___ _   _ _ __  _| |_ 
            |  ___/ _ \ '_ \ / _ \ | | | '_ \| | __|
            | |  |  __/ |_) |  __/ |_| | | | | | |_ 
            |_|   \___| .__/ \___|\__,_|_| |_|_|\__|
                      | |                           
                      |_|   
                   
     v0.9.0 - AGPL v3 License
     Federated IoT Platform
     Front: https://dcunit.pepeunit.com
     REST:  https://dcunit.pepeunit.com/pepeunit/docs
     GQL:   https://dcunit.pepeunit.com/pepeunit/graphql
     TG:    https://t.me/PepeUnitDevRobot
     Docs:  https://pepeunit.com
            
INFO - 2025-09-15 22:09:35,872 - Delete webhook before set new webhook
INFO - 2025-09-15 22:09:35,873 - Connect to mqtt server: dcemqx.pepemoss.com:1885
[2025-09-15 22:09:35 +0000] [44] [INFO] Used broker version is 5
INFO - 2025-09-15 22:09:35,878 - [CONNECTION MADE]
INFO - 2025-09-15 22:09:36,537 - Connect to mqtt server: dcemqx.pepemoss.com:1885
[2025-09-15 22:09:36 +0000] [43] [INFO] Used broker version is 5
INFO - 2025-09-15 22:09:36,543 - [CONNECTION MADE]
INFO - 2025-09-15 22:09:37,882 - MQTT subscriptions initialized in this worker
INFO - 2025-09-15 22:09:37,882 - [SEND SUB] 1 [b'dcunit.pepeunit.com/+/+/+/pepeunit']
INFO - 2025-09-15 22:09:37,884 - [SUBACK] 1 (0,)
[2025-09-15 22:09:37 +0000] [44] [INFO] Application startup complete.
172.20.1.13:38050 - "POST /pepeunit/api/v1/units/auth HTTP/1.0" 200
172.20.1.11:35616 - "GET /pepeunit/metrics HTTP/1.1" 200
INFO - 2025-09-15 22:09:38,548 - Another worker already subscribed to MQTT topics
[2025-09-15 22:09:38 +0000] [43] [INFO] Application startup complete.
172.20.1.13:38058 - "POST /pepeunit/api/v1/bot HTTP/1.0" 422
INFO - 2025-09-15 22:09:38,569 - HTTP Request: POST https://dcunit.pepeunit.com/pepeunit/api/v1/bot "HTTP/1.1 422 Unprocessable Entity"
INFO - 2025-09-15 22:09:38,640 - Success set TG bot webhook url

WARNING

Стоит обратить особое внимание на строчку:

bash

INFO - 2025-03-14 01:11:53,249 - [SUBACK] 1 (0,)

Она отображает смог ли Backend подписаться на топик dcunit.pepeunit.com/+/+/+/pepeunit. Если в скобках будет указано (135,) вместо (0,), то Backend не смог подписаться на основной топик. Обычно это связано со следующими недочётами:

Закрытым портом 1883
Настройкой портов сервиса emqx в docker-compose.yml, вы могли указать другой порт, и не открыли его
При использовании кастомного порта для mqtt, требуется указать его в двух .env файлах: backend и datapipe
Ошибками в настройках EMQX MQTT Broker и Backend, например MQTT_REDIS_AUTH_URL или REDIS_URL. Подробнее о переменных окружения Backend Env. Данные переменные должны смотреть строго на один и тот же инстанас Redis. За первичную авторизацию отвечает именно Redis.

Создание Администратора

Первый созданный пользователь на инстансе Pepeunit автоматически становится Администратором. Для этого достаточно пройти стандартную форму регистрации.

Работа с бэкапами

Запустите Pepeunit командой, это требуется для получения корректной версии
bash
```
docker compose up -d
```
Запустите создание backup командой, бекап делается без прекращения работы контейнеров
bash
```
sudo ./backup.sh backup
```
Развернуть версию из backup, при этом изначально инстанс должен быть полностью выключен командой docker compose down
bash
```
sudo ./backup.sh restore backups/backup_name.tar
```

Обновление

Создайте backup
bash
```
sudo ./backup.sh backup
```
Выполните обновление репозитория
bash
```
git pull
```
Выполните обновление env переменных. Существующие секретные 32 битные ключи изменены не будут. Остальные переменные будут сгенерированны, как при первой генерации, если вы выполняли ручной ввод данных в env/.env.<service-name> файлы, то ваши изменения будут УДАЛЕНЫ, поэтому обязательно делайте backup перед запуском команды. Если у вас очень тонкая настройка, изменяйте настройки в ручную, напрямую в env/.env.<service-name>.
bash
```
python make_env.py
```
Выполните запуск Pepeunit
bash
```
docker compose up -d
```

Полезные команды для дебага

Остановить docker compose
bash
```
docker compose down
```
Запустить docker compose в фоновом режиме
bash
```
docker compose up -d
```
Посмотреть логи конкретного контейнера
bash
```
docker logs postgres
```

Зайти во внутрь контейнера, чтобы посмотреть состояние файлов и тд:

bash

docker exec -it frontend /bin/sh
docker exec -it backend /bin/bash
docker exec -it datapipe /bin/sh
docker exec -it emqx /bin/bash
docker exec -it postgres /bin/bash
docker exec -it redis /bin/bash
docker exec -it nginx /bin/bash
docker exec -it clickhouse /bin/bash

Зайти в консоль базы данных, POSTGRES_USER и POSTGRES_DB можно найти в env/.env.postgres
bash
```
docker exec -it postgres psql -U <POSTGRES_USER> -d <POSTGRES_DB>
psql -U <POSTGRES_USER> -d <POSTGRES_DB>
```
Отправить запрос в clickhouse через curl:
bash
```
curl "http://admin:mypassword@127.0.0.1:8123/?query=SHOW+TABLES"
```

Docker Compose установка Pepeunit ​

Установка Docker ​

Установка Docker Compose ​

Репозиторий Pepeunit Deploy ​

Заполняем первичный .env файл ​

Генерация env/.env.service ​

Настройка Nginx ​

Открытие портов ​

Первый запуск ​

Создание Администратора ​

Работа с бэкапами ​

Обновление ​

Полезные команды для дебага ​

Docker Compose установка Pepeunit

Установка Docker

Установка Docker Compose

Репозиторий Pepeunit Deploy

Заполняем первичный .env файл

Генерация env/.env.service

Настройка Nginx

Открытие портов

Первый запуск

Создание Администратора

Работа с бэкапами

Обновление

Полезные команды для дебага