75 lines
2.4 KiB
Markdown
75 lines
2.4 KiB
Markdown
---
|
|
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.
|