email

Repository: 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 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.

2.4 KiB Raw Blame History