Установка

Инструкция по запуску приложения на локальном компьютере

Для запуска приложения вам потребуется установить Docker и Docker Compose на ваш компьютер. Следуйте шагам ниже:

1. Установите Docker и Docker Compose

Если Docker и Docker Compose еще не установлены, выполните следующие действия:

  • Для Windows и macOS:
    Скачайте и установите Docker Desktop. Docker Compose будет установлен автоматически вместе с Docker Desktop.
  • Для Linux:
    Установите Docker и Docker Compose, следуя официальной документации:
    Установка Docker
    Установка Docker Compose

2. Скачайте архив с проектом

Скачать архив можно Тут

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

Распакуйте скачанный архив в удобную для вас директорию. Например, в папку projects на вашем рабочем столе.

4. Откройте терминал

Для работы с Docker Compose вам нужно использовать терминал (или командную строку). Вот как это сделать:

  • Windows:
    Нажмите Win + R, введите cmd и нажмите Enter. Или используйте PowerShell. Если вы используете WSL (Windows Subsystem for Linux), откройте терминал WSL.
  • macOS:
    Откройте приложение "Терминал" через поиск (Spotlight) или из папки "Утилиты".
  • Linux:
    Откройте терминал через меню приложений или с помощью сочетания клавиш Ctrl + Alt + T.

5. Перейдите в директорию с проектом

В терминале выполните команду cd, чтобы перейти в папку с вашим проектом. Например, если вы распаковали архив в папку projects на рабочем столе, выполните:

cd /*путь до папки с проектом*/ваша_папка_с_проектом

Примечание:
  • ~ обозначает домашнюю директорию пользователя.
  • Если вы не знаете, где находится ваша папка, вы можете перетащить папку в терминал, и путь вставится автоматически (на macOS и Linux).
  • Чтобы проверить, какие файлы находятся в текущей директории, выполните команду ls (на macOS/Linux) или dir (на Windows).

В папке cd ~/Desktop/projects/ваша_папка_с_проектом/database , хранится база приложения. Изначально папка пустая, но после первого запуска в ней создадутся файлы базы данных, ну удаляйте их, иначе потеряете все данные которые внесете в приложение!!!

6. Соберите и запустите приложение

Теперь, когда вы находитесь в директории с проектом, выполните команду для сборки и запуска приложения:

docker-compose up -d

7. Войти в административную часть

После успешного запуска контейнеров откройте браузер и перейдите в административное меню, оно работает на порту 91. Т.е. адрес будет http://localhost:91/admin
логин: admin
пароль: admin123

8. Создаем пользователя для работы в приложении

По умолчанию в системе уже есть один пользователь
логин: test@example.com
пароль: testueser123
Вы можете его удалить или изменить.

В административной части приложения, нужно перейти в раздел "Пользователи", адрес будет http://localhost:91/admin/rainlab/user/users
Там добавляем нового пользователя и сразу его активируем. Все теперь используя почту и логин этого пользователя, можно использовать самое приложение.

9. Проверьте работу приложения

Если в пункте 8 вы не удаляли пользователя и не меняли пароль, то можно использовать следующие
логин: test@example.com
пароль: testueser123

Приложение работает на порту 92. Т.е. адрес будет http://localhost:92, переходим по этому адресу и вводим почту и пароль, которые вы указали в пункте 8

10. Остановка приложения

Если вам нужно остановить приложение, выполните команду в той же директории:

docker-compose down

Эта команда остановит и удалит контейнеры, но сохранит данные в томах (volumes), если они используются.

11. Дополнительные команды

  • Просмотр логов:
    Чтобы просмотреть логи работы контейнеров, выполните: docker-compose logs -f
  • Пересборка образов:
    Если вы внесли изменения в Dockerfile или зависимости, пересоберите образы: docker-compose up --build
  • Очистка Docker:
    Если вам нужно удалить все неиспользуемые образы, тома и контейнеры, выполните: docker system prune -f

Примечания

  • Убедитесь, что порты 91,92 и 5001, не конфликтуют с другими приложениями на вашем компьютере.

Пример работы с терминалом

Если вы новичок в работе с терминалом, вот несколько полезных команд:

  • cd <папка> — перейти в указанную папку.
  • cd .. — перейти на уровень выше (в родительскую папку).
  • ls (macOS/Linux) или dir (Windows) — показать содержимое текущей папки.
  • pwd — показать текущую директорию.
  • clear (macOS/Linux) или cls (Windows) — очистить экран терминала.

12. Дополнительные команды для очистки Docker

Удалить/очистить все данные Докера (контейнеры, образы, тома и сети) Одной строкой

docker stop $(docker ps -qa) && docker rm $(docker ps -qa) && docker rmi -f $(docker images -qa) && docker volume rm $(docker volume ls -q) && docker network rm $(docker network ls -q)

Описание команд

👎 Остановка всех контейнеров

docker stop $(docker ps -qa)

✊ Удаление всех контейнеров

docker rm $(docker ps -qa)

✌️ Удаление всех образов

docker rmi -f $(docker images -qa)

👋 Удаление всех томов

docker volume rm $(docker volume ls -q)

✋ Удаление всех сетей

docker network rm $(docker network ls -q)

Следующие команды не должны выводить какие-либо элементы, если вы все удалили:

docker ps -a

docker images -a

docker volume ls

👉 Следующая команда показывает только сети по умолчанию:

docker network ls

:: Следующая команда удаляет неиспользуемые образы

docker system prune