---
type: project
status: active
source: git.alwisp.com
repo: jason/email
repo_url: https://git.alwisp.com/jason/email
language: HTML
branch: main
tags: [repo, jason]
updated: 2026-05-29
---

# email

**Repository:** [jason/email](https://git.alwisp.com/jason/email) · branch `main` · HTML

## Summary

Self-hosted Dockerized Google Workspace email signature manager — syncs users from Google Directory and pushes HTML signatures directly to Gmail via API

## Current status

Active. Synced from Gitea on 2026-05-29.

## Documentation overview

# Email Signature Manager

A self-hosted, Dockerized Google Workspace email signature manager.
Runs as a single container — designed for Unraid but works on any Docker host.
See [INSTALL.md](INSTALL.md) for Unraid-specific instructions.

## Features

- **Automated Directory Sync** — Pulls user data from Google Workspace Directory API
- **HTML Signature Renderer** — Per-user signatures via Handlebars templates
- **Gmail API Integration** — Pushes signatures directly to Gmail (web + mobile)
- **Nightly Sync** — Automated batch push via configurable cron schedule
- **Web Admin UI** — Management dashboard with live template editor
- **Template Versioning** — Save multiple versions and recall them later
- **Test Mode** — Single-user push for safe testing and onboarding
- **Audit Logging** — SQLite-backed history of every push event
- **Secure Access** — Basic auth protected management interface
- **Self-Hosted** — Single container with internal SQLite, no external DB needed

---

## Logo & Image Hosting

All images referenced in the signature template must be publicly accessible via HTTPS.
The default logo URL is:
```
https://alwisp.com/uploads/logo.png
```
Upload your logo and any other signature images to `https://alwisp.com/uploads/` and
reference them by full URL in the template. The logo URL can also be changed live
in the Template Editor UI without rebuilding the container.

---

## Environment Variables

All secrets and configuration are passed as **environment variables at runtime**.
No `.env` file is committed to this repo — see `.env.example` for all variable names.

| Variable | Description | Default |
|---|---|---|
| `GOOGLE_ADMIN_EMAIL` | Workspace admin email (e.g. jason@messagepoint.tv) | *(required)* |

…(truncated — see repo)

## Notes

- Project file auto-created from repo documentation.