Docker Deployment

Prerequisites

• Docker installed (Install Docker)
• Docker Compose (usually included with Docker Desktop)
• Completed Entra ID setup
• A Windows machine for running the local packager

Quick Start

The fastest way to deploy IntuneGet with Docker:

# Clone your fork (or the main repo)
git clone https://github.com/YOUR_USERNAME/IntuneGet.git
cd IntuneGet

# Copy and configure environment
cp .env.example .env.local

# Edit .env.local with your values
# (Use your favorite editor)

# Start the application
docker-compose up -d

The application will be available at http://localhost:3000

Step-by-Step Setup

git clone https://github.com/YOUR_USERNAME/IntuneGet.git
cd IntuneGet

cp .env.example .env.local

# Database (SQLite mode for self-hosting)
DATABASE_MODE=sqlite
DATABASE_PATH=/data/intuneget.db

# Local Packager
PACKAGER_MODE=local
PACKAGER_API_KEY=your-secure-random-key

# Entra ID
NEXT_PUBLIC_AZURE_AD_CLIENT_ID=your-client-id
AZURE_CLIENT_SECRET=your-client-secret

# Application URL
NEXT_PUBLIC_URL=http://localhost:3000

# Start in detached mode
docker-compose up -d

# View logs
docker-compose logs -f

# Stop
docker-compose down

# Check container status
docker-compose ps

# Test health endpoint
curl http://localhost:3000/api/health

{
  "status": "healthy",
  "mode": "self-hosted",
  "services": {
    "database": true,
    "auth": true,
    "pipeline": true
  }
}

Docker Compose Configuration

The included docker-compose.yml provides a production-ready configuration with SQLite persistence:

1version: '3.8'
2
3services:
4  intuneget:
5    build:
6      context: .
7      dockerfile: Dockerfile
8    ports:
9      - "3000:3000"
10    environment:
11      - DATABASE_MODE=sqlite
12      - DATABASE_PATH=/data/intuneget.db
13      - PACKAGER_MODE=local
14      - PACKAGER_API_KEY=${PACKAGER_API_KEY}
15      - NEXT_PUBLIC_AZURE_AD_CLIENT_ID=${NEXT_PUBLIC_AZURE_AD_CLIENT_ID}
16      - AZURE_CLIENT_SECRET=${AZURE_CLIENT_SECRET}
17      - NEXT_PUBLIC_URL=${NEXT_PUBLIC_URL}
18    volumes:
19      - intuneget-data:/data
20    restart: unless-stopped
21    healthcheck:
22      test: ["CMD", "curl", "-f", "http://localhost:3000/api/health"]
23      interval: 30s
24      timeout: 10s
25      retries: 3
26      start_period: 40s
27
28volumes:
29  intuneget-data:

How Environment Variables Work in Docker

Next.js normally inlines NEXT_PUBLIC_* variables into the client JavaScript at build time. Since the Docker image is built without your specific configuration, IntuneGet uses runtime injection to ensure these values are available in the browser.

When a page is requested, the server reads NEXT_PUBLIC_AZURE_AD_CLIENT_ID from the container's environment and injects it into the HTML. Client-side code (such as MSAL authentication) reads this injected value, so your sign-in and consent URLs always contain the correct client ID.

Reverse Proxy Configuration

For production, place IntuneGet behind a reverse proxy for SSL termination:

server {
    listen 80;
    server_name intuneget.yourdomain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}

intuneget.yourdomain.com {
    reverse_proxy localhost:3000
}

version: '3.8'

services:
  intuneget:
    # ... your existing config ...
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.intuneget.rule=Host(`intuneget.yourdomain.com`)"
      - "traefik.http.routers.intuneget.entrypoints=websecure"
      - "traefik.http.routers.intuneget.tls.certresolver=letsencrypt"

SSL/TLS

Updating Your Deployment

To update to the latest version:

# Pull latest changes
git pull origin main

# Rebuild and restart
docker-compose down
docker-compose build --no-cache
docker-compose up -d

Production Checklist

Common Issues