Files
docker-compose-cookbooks/notifuse_dev/README.md
T
codeandClaude Fable 5 b4375c3e09 add 23 requested stacks from container-requests list
Tdarr, Grocy, Dashy, Traefik, Fider, Twenty CRM, Outline, Chatwoot,
ComfyUI, Picard, VoidAuth, Tinyauth, Tugtainer, Sencho, Authelia,
Mail Archiver, ITFlow, Notifuse, Maybe Finance, DumbBudget, Silverpeas,
Portus, Obsidian — all as _dev stacks following repo conventions.

Harbor and Exportify moved to 'Apps That Will Not be in the Repo'
(installer-generated compose / no published image).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-16 06:24:26 +00:00

62 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Notifuse
## Overview
Newsletter, marketing campaign, and transactional email platform (open-source Mailchimp/Resend alternative).
## Project Details
- **Project Repository:** [GitHub](https://github.com/Notifuse/notifuse)
- **Container Image:** [notifuse/notifuse](https://hub.docker.com/r/notifuse/notifuse)
- **Documentation:** [docs.notifuse.com](https://docs.notifuse.com/self-hosting/installation)
- **Reverse Proxy Port:** `8080`
## Getting Started
1. Start the container: `docker compose up -d`
2. Open http://localhost:8080 in your browser
3. Follow the initial setup wizard to configure the application
## Environment Variable Notes
NOTIFUSE_SECRET_KEY encrypts all workspace secrets; NEVER change after setup or all stored credentials are lost
NOTIFUSE_ROOT_EMAIL initial admin account
NOTIFUSE_API_ENDPOINT public URL of the instance
## Volume Notes
/var/lib/postgresql/data PostgreSQL data
## Network Notes
Requires proxy network
## Docker Run
```bash
docker run -d \
--name notifuse \
-p 8080:8080 \
-e API_ENDPOINT=http://localhost:8080 \
-e ROOT_EMAIL=admin@example.com \
-e SECRET_KEY=changeme \
-e DB_HOST=dbhost -e DB_USER=notifuse -e DB_PASSWORD=pass -e DB_NAME=notifuse \
notifuse/notifuse:latest
```
## Additional Notes / Gotchas
Notifuse creates a separate Postgres database per workspace, so the DB user needs CREATEDB privileges (the postgres superuser in this stack has it).
Sending requires an email provider (SES, Mailgun, SendGrid, Postmark, or SMTP) configured in the setup wizard.
## Dockhand Stack, Deploy from Git
Cookbooks Repository
stackname: notifuse_dev
Compose file path: notifuse_dev/compose.yaml
Additional env file (optional): notifuse_dev/sample.env
Then "Load" notifuse_dev/sample.env into the Environmental variables in dockhand
Create the Stack