🚀 Getting Started
🔧 Manual Setup (Development)
Prerequisites
- Go 1.21+
- MongoDB
- Redis (optional, recommended)
- Google OAuth Credentials
- Node.js (v18+)
- PNPM
Run the Backend
Bash
git clone https://github.com/melvinodsa/go-iam.git
cd go-iam
cp sample.env .env
go run main.go
Run the Frontend
Bash
git clone https://github.com/melvinodsa/go-iam-ui.git
cd go-iam-ui
pnpm install
cp sample.env .env
Access
- Admin UI: http://localhost:5173
- API: http://localhost:3000
- API Docs: http://localhost:3000/docs
📦 Environment Variables
Variable | Description |
|---|---|
| `LOGGER_LEVEL` | Logger level `1 - Debug` (refer., `https://docs.gofiber.io/api/log/`) |
| `DB_HOST` | MongoDB URI (e.g., `mongodb://user:pass@host/db`) |
| `JWT_SECRET` | Secret key used for generating and verifying JWT tokens |
| `REDIS_HOST`, `REDIS_PASSWORD`, `ENABLE_REDIS` | Redis host address and toggle to enable Redis caching |
| `ENCRYPTER_KEY` | Optional symmetric key for encrypting sensitive fields - change this |
| `AUTH_PROVIDER_REFETCH_INTERVAL_IN_MINUTES` | Interval in minutes to refetch and sync third-party auth providers |
| `TOKEN_CACHE_TTL_IN_MINUTES` | Interval for which the authentication token should be valid |