Notifuse

Limitations

• Outbound deliverability and IP reputation fall entirely on the operator, requiring manual configuration of SPF, DKIM, DMARC, and webhook endpoints for bounces.
• Commercial licensing applies to advanced capabilities, requiring a paid license key for Single Sign-On, custom role permissions, or hosting more than three workspaces.
• Upstream development is handled in-house by the core author, with unsolicited pull requests closed on GitHub in favor of issue-driven proposals.
• Running separate PostgreSQL databases per workspace increases maintenance and backup overhead on single-node VPS setups.

Who should use it

• Digital agencies managing multiple client newsletters that need segregated databases and asset hosting without per-subscriber software bills.
• Product engineers and ops leads seeking to unify transactional alerts and marketing broadcasts through a single self-hosted service and an Amazon SES account.
• Privacy-conscious teams that must retain complete control over subscriber data and contact logs to comply with strict data residency rules.

FAQ

Can I self-host Notifuse with Docker? Yes. The project provides official Docker images and compose manifests configured for a Go backend, React console, and PostgreSQL database.

Notifuse vs Mailchimp — which should a small team choose? Choose Mailchimp if you want an all-in-one hosted service that manages IP reputation and email deliverability automatically. Pick Notifuse if you have existing cloud infrastructure, prefer wholesale delivery rates via Amazon SES, and want full control over your subscriber data.

Which email delivery providers does Notifuse support? Notifuse includes native integrations for Amazon SES, Mailgun, Postmark, Mailjet, SparkPost, and standard SMTP relays.

Verdict

Notifuse is an effective self-hosted platform for agencies and engineering teams that want to eliminate per-contact SaaS fees by connecting their own delivery infrastructure, provided they are prepared to handle DNS records and deliverability monitoring. Active maintenance through regular commits and its source-available Business Source License ensure modern tooling, though teams needing enterprise single sign-on or more than three workspaces should account for commercial licensing fees.

Ubuntu 24.04 · Apple container, Docker 29.1.3, Compose 2.40.3+ds1-0ubuntu1~24.04.1. Images pulled in 36 s: postgres:17-alpine, notifuse/notifuse:v42.1.

Based on the upstream setup. Upstream compose with notifuse/notifuse image pinned to v42.1; database password and secret key moved to .env.

api-1       | 2026-11-03T12:33:24.202512005Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Task scheduler will start in 30 seconds..."}
api-1       | 2026-11-03T12:33:24.202520297Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Email queue worker will start in 30 seconds..."}
api-1       | 2026-11-03T12:33:24.202533880Z {"level":"info","delay":30000000000,"time":"2026-11-03T12:33:24Z","message":"Automation scheduler will start after delay..."}
api-1       | 2026-11-03T12:33:24.273412505Z {"level":"info","email":"[email protected]","time":"2026-11-03T12:33:24Z","message":"Setup wizard completed successfully"}
api-1       | 2026-11-03T12:33:24.774661797Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Setup completed - initiating graceful shutdown for configuration reload"}
api-1       | 2026-11-03T12:33:24.774981339Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Starting graceful shutdown..."}
api-1       | 2026-11-03T12:33:24.774983547Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Stopping blog cache..."}
api-1       | 2026-11-03T12:33:24.774984339Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Server shutdown initiated during webhook worker delay, worker will not start"}
api-1       | 2026-11-03T12:33:24.774985130Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Server shutdown during automation scheduler delay"}
api-1       | 2026-11-03T12:33:24.774985797Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Server shutdown initiated during email queue worker delay, worker will not start"}
api-1       | 2026-11-03T12:33:24.774992714Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Server shutdown initiated during task scheduler delay, scheduler will not start"}
api-1       | 2026-11-03T12:33:24.774995964Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Flushing web analytics buffer..."}
api-1       | 2026-11-03T12:33:24.774996630Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Stopping automation scheduler..."}
api-1       | 2026-11-03T12:33:24.774997380Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Stopping email queue worker..."}
api-1       | 2026-11-03T12:33:24.774998005Z {"level":"info","active_requests":0,"time":"2026-11-03T12:33:24Z","message":"Active requests at shutdown start"}
api-1       | 2026-11-03T12:33:24.774998714Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"Waiting for active requests to complete..."}
api-1       | 2026-11-03T12:33:24.774999339Z {"level":"info","time":"2026-11-03T12:33:24Z","message":"All requests completed"}
api-1       | 2026-11-03T12:33:24.774999922Z {"level":"info","timeout":60000000000,"time":"2026-11-03T12:33:24Z","message":"Starting HTTP server shutdown"}
api-1       | 2026-11-03T12:33:24.775000630Z {"level":"error","error":"http: Server closed","time":"2026-11-03T12:33:24Z","message":"Server error"}
api-1       | 2026-11-03T12:33:25.005936339Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Starting API server on 0.0.0.0:8080"}
api-1       | 2026-11-03T12:33:25.005982672Z {"level":"info","version":"42.1","time":"2026-11-03T12:33:25Z","message":"Starting Notifuse application"}
api-1       | 2026-11-03T12:33:25.005998255Z {"level":"info","max_active_contacts":"unlimited","max_stored_contacts":"unlimited","max_monthly_events":"unlimited","max_monthly_pageviews":"unlimited","data_retention_months":"unlimited","time":"2026-11-03T12:33:25Z","message":"Plan limits resolved"}
api-1       | 2026-11-03T12:33:25.006009630Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Connecting to database postgres:5432, user postgres, sslmode disable, password: C...e, dbname: notifuse_system"}
api-1       | 2026-11-03T12:33:25.009463214Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"System database check completed"}
api-1       | 2026-11-03T12:33:25.019120214Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Starting migration process"}
api-1       | 2026-11-03T12:33:25.019329380Z {"level":"info","db_version":"42","code_version":"42","time":"2026-11-03T12:33:25Z","message":"Version comparison"}
api-1       | 2026-11-03T12:33:25.019340672Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Database is up to date, no migrations needed"}
api-1       | 2026-11-03T12:33:25.019342630Z {"level":"info","max_connections":100,"max_connections_per_db":3,"time":"2026-11-03T12:33:25Z","message":"Connection manager initialized"}
api-1       | 2026-11-03T12:33:25.020170964Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"System installation verified"}
api-1       | 2026-11-03T12:33:25.020180589Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Blog cache initialized"}
api-1       | 2026-11-03T12:33:25.020187130Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Using SMTP mailer for production"}
api-1       | 2026-11-03T12:33:25.021148130Z {"level":"info","state":"none","tier":"community","max_workspaces":"3","sso_gated":false,"audit_logs_recording":false,"key_source":"none","org":"","expires_at":"n/a","features":"","time":"2026-11-03T12:33:25Z","message":"Licence resolved"}
api-1       | 2026-11-03T12:33:25.021156880Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Annotation service registered with event bus"}
api-1       | 2026-11-03T12:33:25.021158089Z {"level":"info","task_type":"send_broadcast","time":"2026-11-03T12:33:25Z","message":"Registered task processor"}
api-1       | 2026-11-03T12:33:25.021158964Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Broadcast orchestrator registered with task service"}
api-1       | 2026-11-03T12:33:25.021159630Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"TaskService subscribed to broadcast events"}
api-1       | 2026-11-03T12:33:25.021160380Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"System notification service registered with event bus"}
api-1       | 2026-11-03T12:33:25.021161005Z {"level":"info","task_type":"build_segment","time":"2026-11-03T12:33:25Z","message":"Registered task processor"}
api-1       | 2026-11-03T12:33:25.021161672Z {"level":"info","task_type":"check_segment_recompute","time":"2026-11-03T12:33:25Z","message":"Registered task processor"}
api-1       | 2026-11-03T12:33:25.021162380Z {"level":"info","task_type":"process_contact_segment_queue","time":"2026-11-03T12:33:25Z","message":"Registered task processor"}
api-1       | 2026-11-03T12:33:25.021470422Z {"level":"info","task_type":"sync_integration","time":"2026-11-03T12:33:25Z","message":"Registered task processor"}
api-1       | 2026-11-03T12:33:25.021471339Z {"level":"info","task_type":"web_analytics_backfill","time":"2026-11-03T12:33:25Z","message":"Registered task processor"}
api-1       | 2026-11-03T12:33:25.021472172Z {"level":"info","path":"/app/geoip/GeoLite2-City.mmdb","time":"2026-11-03T12:33:25Z","message":"GeoIP database loaded"}
api-1       | 2026-11-03T12:33:25.022817630Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Application successfully initialized"}
api-1       | 2026-11-03T12:33:25.023286547Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Server started successfully"}
api-1       | 2026-11-03T12:33:25.023291255Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Graceful shutdown middleware enabled"}
api-1       | 2026-11-03T12:33:25.023292172Z {"level":"info","address":"0.0.0.0:8080","api_endpoint":"http://localhost:8080","port":8080,"time":"2026-11-03T12:33:25Z","message":"Server starting on 0.0.0.0:8080 with API endpoint: http://localhost:8080"}
api-1       | 2026-11-03T12:33:25.023293214Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Web analytics maintenance worker started"}
api-1       | 2026-11-03T12:33:25.023294047Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Webhook delivery worker will start in 30 seconds..."}
api-1       | 2026-11-03T12:33:25.023294672Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Task scheduler will start in 30 seconds..."}
api-1       | 2026-11-03T12:33:25.023300172Z {"level":"info","time":"2026-11-03T12:33:25Z","message":"Email queue worker will start in 30 seconds..."}
api-1       | 2026-11-03T12:33:25.023300880Z {"level":"info","delay":30000000000,"time":"2026-11-03T12:33:25Z","message":"Automation scheduler will start after delay..."}
api-1       | 2026-11-03T12:33:55.024816338Z {"level":"info","time":"2026-11-03T12:33:55Z","message":"Starting automation scheduler now"}
api-1       | 2026-11-03T12:33:55.024842921Z {"level":"info","interval":10000000000,"batch_size":50,"time":"2026-11-03T12:33:55Z","message":"Starting automation scheduler"}
api-1       | 2026-11-03T12:33:55.024844546Z {"level":"info","time":"2026-11-03T12:33:55Z","message":"Starting webhook delivery worker now"}
api-1       | 2026-11-03T12:33:55.024848504Z {"level":"info","time":"2026-11-03T12:33:55Z","message":"Webhook delivery worker started"}
api-1       | 2026-11-03T12:33:55.024849504Z {"level":"info","time":"2026-11-03T12:33:55Z","message":"Starting email queue worker now"}
api-1       | 2026-11-03T12:33:55.024850296Z {"level":"info","worker_count":5,"poll_interval":"1s","batch_size":200,"send_concurrency":10,"smtp_send_concurrency":1,"round_window":"2s","time":"2026-11-03T12:33:55Z","message":"Starting email queue worker"}
api-1       | 2026-11-03T12:33:55.024915713Z {"level":"info","time":"2026-11-03T12:33:55Z","message":"Starting task scheduler now"}
api-1       | 2026-11-03T12:33:55.024964421Z {"level":"info","interval":20000000000,"max_tasks":100,"time":"2026-11-03T12:33:55Z","message":"Starting internal task scheduler"}
api-1       | 2026-11-03T12:33:55.028535004Z {"level":"info","task_count":0,"time":"2026-11-03T12:33:55Z","message":"Retrieved batch of tasks to process"}
api-1       | 2026-11-03T12:34:15.033428556Z {"level":"info","task_count":0,"time":"2026-11-03T12:34:15Z","message":"Retrieved batch of tasks to process"}
api-1       | 2026-11-03T12:34:35.031041258Z {"level":"info","task_count":0,"time":"2026-11-03T12:34:35Z","message":"Retrieved batch of tasks to process"}
api-1       | 2026-11-03T12:34:55.031237669Z {"level":"info","task_count":0,"time":"2026-11-03T12:34:55Z","message":"Retrieved batch of tasks to process"}
api-1       | 2026-11-03T12:35:15.034844762Z {"level":"info","task_count":0,"time":"2026-11-03T12:35:15Z","message":"Retrieved batch of tasks to process"}
api-1       | 2026-11-03T12:35:35.031794173Z {"level":"info","task_count":0,"time":"2026-11-03T12:35:35Z","message":"Retrieved batch of tasks to process"}
api-1       | 2026-11-03T12:35:55.032229626Z {"level":"info","task_count":0,"time":"2026-11-03T12:35:55Z","message":"Retrieved batch of tasks to process"}
api-1       | 2026-11-03T12:36:15.028866385Z {"level":"info","task_count":0,"time":"2026-11-03T12:36:15Z","message":"Retrieved batch of tasks to process"}
postgres-1  | 2026-11-03T12:33:18.564262377Z The default text search configuration will be set to "english".
postgres-1  | 2026-11-03T12:33:18.564263002Z 
postgres-1  | 2026-11-03T12:33:18.564263502Z Data page checksums are disabled.
postgres-1  | 2026-11-03T12:33:18.564264044Z 
postgres-1  | 2026-11-03T12:33:18.564264544Z fixing permissions on existing directory /var/lib/postgresql/data ... ok
postgres-1  | 2026-11-03T12:33:18.566022086Z creating subdirectories ... ok
postgres-1  | 2026-11-03T12:33:18.566030711Z selecting dynamic shared memory implementation ... posix
postgres-1  | 2026-11-03T12:33:18.573756252Z selecting default "max_connections" ... 100
postgres-1  | 2026-11-03T12:33:18.582473877Z selecting default "shared_buffers" ... 128MB
postgres-1  | 2026-11-03T12:33:18.593965002Z selecting default time zone ... UTC
postgres-1  | 2026-11-03T12:33:18.594218752Z creating configuration files ... ok
postgres-1  | 2026-11-03T12:33:18.641524919Z running bootstrap script ... ok
postgres-1  | 2026-11-03T12:33:18.704688377Z sh: locale: not found
postgres-1  | 2026-11-03T12:33:18.704708044Z 2026-11-03 12:33:18.704 UTC [34] WARNING:  no usable system locales were found
postgres-1  | 2026-11-03T12:33:18.842880502Z performing post-bootstrap initialization ... ok
postgres-1  | 2026-11-03T12:33:18.889059127Z syncing data to disk ... ok
postgres-1  | 2026-11-03T12:33:18.889082961Z 
postgres-1  | 2026-11-03T12:33:18.889084586Z 
postgres-1  | 2026-11-03T12:33:18.889085586Z Success. You can now start the database server using:
postgres-1  | 2026-11-03T12:33:18.889086169Z 
postgres-1  | 2026-11-03T12:33:18.889087627Z     pg_ctl -D /var/lib/postgresql/data -l logfile start
postgres-1  | 2026-11-03T12:33:18.889088419Z 
postgres-1  | 2026-11-03T12:33:18.889130377Z initdb: warning: enabling "trust" authentication for local connections
postgres-1  | 2026-11-03T12:33:18.889132586Z initdb: hint: You can change this by editing pg_hba.conf or using the option -A, or --auth-local and --auth-host, the next time you run initdb.
postgres-1  | 2026-11-03T12:33:18.911125836Z waiting for server to start....2026-11-03 12:33:18.910 UTC [40] LOG:  starting PostgreSQL 17.11 on aarch64-unknown-linux-musl, compiled by gcc (Alpine 15.2.0) 15.2.0, 64-bit
postgres-1  | 2026-11-03T12:33:18.912077377Z 2026-11-03 12:33:18.912 UTC [40] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
postgres-1  | 2026-11-03T12:33:18.913612586Z 2026-11-03 12:33:18.913 UTC [43] LOG:  database system was shut down at 2026-11-03 12:33:18 UTC
postgres-1  | 2026-11-03T12:33:18.915686086Z 2026-11-03 12:33:18.915 UTC [40] LOG:  database system is ready to accept connections
postgres-1  | 2026-11-03T12:33:19.000745919Z  done
postgres-1  | 2026-11-03T12:33:19.000760044Z server started
postgres-1  | 2026-11-03T12:33:19.006779377Z 
postgres-1  | 2026-11-03T12:33:19.006823752Z /usr/local/bin/docker-entrypoint.sh: ignoring /docker-entrypoint-initdb.d/*
postgres-1  | 2026-11-03T12:33:19.006842169Z 
postgres-1  | 2026-11-03T12:33:19.007126627Z 2026-11-03 12:33:19.007 UTC [40] LOG:  received fast shutdown request
postgres-1  | 2026-11-03T12:33:19.008474294Z waiting for server to shut down....2026-11-03 12:33:19.007 UTC [40] LOG:  aborting any active transactions
postgres-1  | 2026-11-03T12:33:19.009582211Z 2026-11-03 12:33:19.009 UTC [40] LOG:  background worker "logical replication launcher" (PID 46) exited with exit code 1
postgres-1  | 2026-11-03T12:33:19.009594252Z 2026-11-03 12:33:19.009 UTC [41] LOG:  shutting down
postgres-1  | 2026-11-03T12:33:19.010416127Z 2026-11-03 12:33:19.010 UTC [41] LOG:  checkpoint starting: shutdown immediate
postgres-1  | 2026-11-03T12:33:19.012911211Z 2026-11-03 12:33:19.012 UTC [41] LOG:  checkpoint complete: wrote 3 buffers (0.0%); 0 WAL file(s) added, 0 removed, 0 recycled; write=0.002 s, sync=0.001 s, total=0.004 s; sync files=2, longest=0.001 s, average=0.001 s; distance=0 kB, estimate=0 kB; lsn=0/14F3F88, redo lsn=0/14F3F88
postgres-1  | 2026-11-03T12:33:19.013924377Z 2026-11-03 12:33:19.013 UTC [40] LOG:  database system is shut down
postgres-1  | 2026-11-03T12:33:19.111139628Z  done
postgres-1  | 2026-11-03T12:33:19.111156169Z server stopped
postgres-1  | 2026-11-03T12:33:19.111511628Z 
postgres-1  | 2026-11-03T12:33:19.111515586Z PostgreSQL init process complete; ready for start up.
postgres-1  | 2026-11-03T12:33:19.111516419Z 
postgres-1  | 2026-11-03T12:33:19.119518461Z 2026-11-03 12:33:19.119 UTC [1] LOG:  starting PostgreSQL 17.11 on aarch64-unknown-linux-musl, compiled by gcc (Alpine 15.2.0) 15.2.0, 64-bit
postgres-1  | 2026-11-03T12:33:19.119551586Z 2026-11-03 12:33:19.119 UTC [1] LOG:  listening on IPv4 address "0.0.0.0", port 5432
postgres-1  | 2026-11-03T12:33:19.119553711Z 2026-11-03 12:33:19.119 UTC [1] LOG:  listening on IPv6 address "::", port 5432
postgres-1  | 2026-11-03T12:33:19.120866919Z 2026-11-03 12:33:19.120 UTC [1] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
postgres-1  | 2026-11-03T12:33:19.122144794Z 2026-11-03 12:33:19.122 UTC [54] LOG:  database system was shut down at 2026-11-03 12:33:19 UTC
postgres-1  | 2026-11-03T12:33:19.124034294Z 2026-11-03 12:33:19.123 UTC [1] LOG:  database system is ready to accept connections
postgres-1  | 2026-11-03T12:33:24.158797547Z 2026-11-03 12:33:24.157 UTC [65] FATAL:  database "notifuse_system" does not exist