# homepage Stack

description: NetGrimoire Homepage Service

published: true
date: 2026-04-07T00:49:28.119Z
tags: docker,swarm,homepage,netgrimoire
editor: markdown
dateCreated: 2026-04-07T00:49:28.119Z
---

## Overview

The homepage stack in NetGrimoire provides a central point for accessing the application's homepage, featuring the Caddy reverse proxy and Uptime Kuma monitoring. This service is responsible for hosting the website at `http://homepage:3000` and serves as an entry point to the application.

---

## Architecture
| Service | Image | Port | Role |
|---------|-------|------|-----|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** homepage.netgrimoire.com, glancenetgrimoire.com (via Caddy)
- **Homepage group:** homepage

---

## Build & Configuration

### Prerequisites
No specific prerequisites are required for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/homepage/config
chown -R docker:docker /DockerVol/homepage/config
```

### Environment Variables
```bash
# generate: openssl rand -hex 32
HOMEPAGE_ALLOWED_HOSTS=homepage.netgrimoire.com,glance.netgrimoire.com
```

### Deploy
```bash
cd services/swarm/stack/homepage
set -a && source .env && set +a
docker stack config --compose-file homepage-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml homepage
rm resolved.yml
docker stack services homepage
```

### First Run

After the initial deployment, ensure that all volumes are properly mounted and configured.

---

## User Guide

### Accessing homepage
| Service | URL | Purpose |
|---------|-----|---------|
- **Caddy Reverse Proxy**: http://homepage:3056

### Primary Use Cases
To access the application's homepage, navigate to `http://homepage:3056` or `https://homepage.netgrimoire.com`.

### NetGrimoire Integrations
This service connects to other services via environment variables and labels. Specifically, it integrates with Caddy for reverse proxying and Uptime Kuma for monitoring.

---

## Operations

### Monitoring
```bash
docker stack services homepage
docker-compose -f /etc/kubernetes/adminstack/up kuma.yml logs -f
```

### Backups
Critical: `/DockerVol/homepage/config/secrets.env` contains sensitive data. Reconstructable volumes are mounted on Docker Vol.

### Restore
```bash
cd services/swarm/stack/homepage
./deploy.sh
```

---

## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
- Caddy Reverse Proxy not working | Insufficient configuration or missing environment variables. | Review and update Caddy configuration and environment variables.
- Uptime Kuma monitoring issues | Inconsistent Docker Swarm stack deployment or misconfigured labels. | Verify that the `kuma.*` labels are correctly applied to the service.

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
- 2026-04-06 | e6f86e24 | Initial documentation and migration to swarm configuration. |
- 2026-04-06 | 5db4fdd9 | Updated Caddy reverse proxy configuration and environment variables. |
- 2026-03-22 | c4ac5abf | Added Uptime Kuma monitoring integration. |
- 2026-01-20 | 061ab0c2 | Improved volume setup and mount permissions. |
- 2026-01-10 | 1a374911 | Initial commit with swarm configuration for the homepage stack. |

<This service has undergone significant changes in its recent commits, including updates to Caddy reverse proxy configuration and Uptime Kuma monitoring integration. Review these sections to ensure you're familiar with the latest implementation details.>

---

## Notes
- Generated by Gremlin on 2026-04-07T00:49:28.119Z
- Source: swarm/homepage.yaml
- Review User Guide and Changelog sections