crank/docs/installation.md

Установка

Самый простой способ запустить Crank - использовать готовые Docker-образы и docker compose.

Требования

• Docker;
• Docker Compose;
• PostgreSQL или локальный compose-профиль local-db;
• свободные порты 3000, 3001, 3002.

Быстрый запуск

mkdir -p crank
cd crank
curl -fsSLo docker-compose.yml https://git.itexp.me/bsodfather/crank/raw/branch/main/deploy/community/docker-compose.images.yml
curl -fsSLo .env.example https://git.itexp.me/bsodfather/crank/raw/branch/main/deploy/community/.env.images.example
cp .env.example .env

Откройте .env и замените значения:

• POSTGRES_PASSWORD;
• CRANK_MASTER_KEY;
• CRANK_SESSION_SECRET;
• CRANK_PASSWORD_PEPPER;
• CRANK_BOOTSTRAP_ADMIN_EMAIL;
• CRANK_BOOTSTRAP_ADMIN_PASSWORD;
• CRANK_BASE_URL.

Секреты можно сгенерировать командой:

openssl rand -hex 32

Запуск с локальным PostgreSQL из compose:

docker compose --profile local-db up -d

Если PostgreSQL уже есть отдельно, укажите его в .env и запустите без профиля:

docker compose up -d

Проверка

docker compose ps
curl http://127.0.0.1:3001/health
curl http://127.0.0.1:3002/health

После запуска откройте веб-интерфейс:

http://localhost:3000

Обновление

docker compose --profile local-db pull
docker compose --profile local-db up -d

Если используете внешний PostgreSQL:

docker compose pull
docker compose up -d

Следующий шаг

После установки пройдите первый инструмент. Если что-то не запускается, используйте troubleshooting.