Listmonk

High performance newsletter and mailing list manager with a modern dashboard.

Access Web Interface

  • Open your browser: http://<SERVER_IP>:9000
  • Login with credentials stored at /root/.cloudzy-creds

Important Files & Directories

  • /opt/listmonk → Main installation directory containing the binary, configuration, and uploads.
  • /opt/listmonk/listmonk → Listmonk executable.
  • /opt/listmonk/config.toml → Main configuration file.
  • /opt/listmonk/uploads → Media uploads directory. Must be created with proper permissions (chown listmonk:listmonk, chmod 700).
  • /root/.cloudzy-creds → Stores admin and PostgreSQL credentials. Permissions should be 400.
  • /var/lib/postgresql/ → PostgreSQL data directory.
  • /etc/postgresql/ → PostgreSQL configuration.
  • /etc/systemd/system/listmonk.service → systemd unit file for the Listmonk service.

Quick Fixes and Operational Tips

Uploaded image thumbnails not viewable

Admin → Settings (http://<SERVER_IP>:9000/admin/settings) → General → set Root URL to http://<SERVER_IP>:9000

Media upload failure

Admin → Settings (http://<SERVER_IP>:9000/admin/settings) → Media uploads → set Upload path to /opt/listmonk/uploads

Ensure correct permissions:

mkdir -p /opt/listmonk/uploads
chown -R listmonk:listmonk /opt/listmonk/uploads
chmod 700 /opt/listmonk/uploads

Manage Listmonk systemd service

# Restart 
systemctl restart listmonk

# Check status
systemctl status listmonk

# View logs
journalctl -u listmonk -f

PostgreSQL Access

Credentials are securely stored at: /root/.cloudzy-creds

# Login as postgres user
sudo -iu postgres

# Open PostgreSQL prompt
psql

# Connect to Listmonk database
c listmonk

# Lists all tables in the listmonk database
dt

# Exit psql
q

Notes

  • Ensure SMTP connections are allowed for this server (ask for enabling SMTP access).
  • Security: Listmonk runs under listmonk user; PostgreSQL runs under postgres.

Documents

  • Setup and usage guide: https://gist.github.com/MaximilianKohler/e5158fcfe6de80a9069926a67afcae11
  • Configuration: https://listmonk.app/docs/configuration/
Currently unavailable.

Application Details