iam-front/deploy

IAM Front Deployment Guide

1. Prerequisites

• Docker & Docker Compose installed
• iam-service running (and accessible from this host)
• .env file configured (copied from .env.example)

2. Configuration (.env)

Ensure .env exists in iam-front/ root.

Critical Variables:

• IAM_SERVICE_BASE_URL: URL to access iam-service.
  • Docker Note: Do NOT use localhost or 127.0.0.1. Use the host IP (e.g. http://192.168.1.100:3000).
• CAPTCHA_SECRET: Secure random string for cookie signing.
• PORT: Optional, defaults to 6020.

3. Deploy

cd deploy/docker
bash start.sh

This will:

1. Validate .env configuration (checks for localhost issues).
2. Build the Docker image.
3. Start the container with ports mapped (default 6020).

4. Stop

cd deploy/docker
bash stop.sh

5. Notes

• This deployment only includes the iam-front service.
• It assumes iam-service is deployed separately.
• No database or Redis is required for the frontend.