composer.json

{
    "require": {
        "php": ">=5.5.0",
        "ext-gettext": "*"
    }
}

Sendy.md

Sendy

Sendy is a self hosted email newsletter application that lets you send trackable emails via Amazon Simple Email Service (SES).

Heroku

You can deploy Sendy on Heroku using the following instructions (I assume you've already installed the heroku toolbelt).

1. On Heroku, create a new app.
2. Clone that app to your desktop git clone [email protected]:YOURAPP.git -o heroku
3. Add the free cleardb addon to your project heroku addons:add cleardb
4. Add the included composer.json file to the root of your cloned directory.
5. Customise the includes/config.php and include the following snippet to use the ClearDB addon previously selected on Heroku:

   <?php
   define('APP_PATH', 'http://yourdomain.com');

   $url_cleardb = parse_url(getenv("CLEARDB_DATABASE_URL"));

   /*  MySQL database connection credentials  */
   $dbHost = $url_cleardb['host']; //MySQL Hostname
   $dbUser = $url_cleardb['user']; //MySQL Username
   $dbPass = $url_cleardb['pass']; //MySQL Password
   $dbName = substr($url_cleardb["path"],1); //MySQL Database Name

All these settings are necessary to Heroku to automatically hook up the ClearDB add-on. More on the settings here.

6. Commit all the changes and push to Heroku:

   git add -A .
   git commit -am "Sendy customised for heroku deployment"
   git push heroku master

7. Follow the remaining Sendy setup steps (http://sendy.co/get-started) starting with Step 5.

Seting up Cron

Cron will make your experience much nicer, and not lock up your site.

1. Add the heroku scheduler: heroku addons:add scheduler:standard
2. Open the scheduler: heroku addons:open scheduler
3. Create two jobs, each with a frequency of 10 mins, and 1x dyno

• Task 1: php autoresponders.php > /dev/null 2>&1
• Task 2: php scheduled.php > /dev/null 2>&1

FAQs

You can add your own domain/subdomain easily: heroku domains:add YOUR.DOMAIN.COM Then go to your Domain Registrant and add a CNAME with the value of your app:

Record	Name	Target
CNAME	YOUR	YOUR-APP.herokuapp.com.

Replacing of course the name to match the subdomain of your choosing, and appending to your domain record.

I just successfully installed sendy on heroku! Thx for this!

There was an error after pushing up to heroku with this guide as of 2nd February 2016.

If you see an error like this:

2016-02-01T16:46:57.673046+00:00 app[web.1]: [01-Feb-2016 16:46:57 UTC] PHP Fatal error:  'break' not in the 'loop' or 'switch' context in /app/includes/functions.php(5) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code(1) : eval()'d code on line 3

Tweak composer.json file in this gist should be modified to use PHP 5 instead of any versions of PHP above 5.5 which may end up using PHP 7 on Heroku.

composer.json should be:

{
    "require": {
        "php": "^5.5.0",
        "ext-gettext": "*"
    }
}

I chose to use PHP 5.5. I suppose 5.6 or 5.7 should work as well. Should probably use the latest to avoid security vulnerabilities.

@Tam-Vo
For guys getting this error:

remote:        Warning: This development build of composer is over 30 days old. It is recommended to update it by running "/app/.heroku/php/bin/composer self-update" to get the latest version.
remote:        Loading composer repositories with package information
remote:        Installing dependencies from lock file
remote:        Warning: The lock file is not up to date with the latest changes in composer.json. You may be getting outdated dependencies. Run update to update them.

Make sure to run composer update!

For those not familiar with composer, you need to first install it. https://getcomposer.org/download/

I don't code in PHP so I had to install PHP on my mac with brew install php56 https://github.com/Homebrew/homebrew-php

Need help with my deployment. Works fine on Heroku. However, when I schedule a campaign, the scheduler runs and sends to zero recipients. What could be the problem?

Installs ok, but there can be some unforseen issues.

• Importing email list by CSV doesn't work until you add this to composer.json

    "scripts": {
        "compile": [
          "mkdir -p -m 777 uploads/csvs/"
        ]
    }

• ClearDB is limited to a maximum of 3600 queries per hour. If you go over this limit, for example by importing a long email list, the database will stop responding for an hour, giving the site the appearance of being broken.
• Cron jobs run every 10 minutes don't work, so that breaks a lot of functionality.

Thanks a lot for this. I got an initial install on Heroku with this guide. But it turns out that Heroku has problems with regard to the ephemeral filesystem and permissions for the /uploads folder. Reading more posts from the Sendy community, I finally went with DigitalOcean as the host.

I fully documented my install process here: https://medium.com/@alexjacobs/installing-sendy-as-a-replacement-for-mailchimp-2019-update-the-complete-guide-with-automated-5a59c4bd7249

It includes enabling https / making daily mysql backups / archiving the mysql backups in an AWS S3 bucket.