Keila - Open Source Mailchimp Alternative Built in Elixir!

wmnnd · February 11, 2021, 12:29pm

Hey folks,

I wanted to share with you a project I’ve been working on for a while: It’s an Open Source (AGPLv3) newsletter tool. Think Mailchimp, but written in Elixir and you can run it on your own server.

Check out the website with a little demo video here:

Recently, people have been talking about the PETAL stack - and it fits Keila quite well: It’s built with Phoenix/Elixir, uses Tailwind for styling, and bit of AlpineJS sprinkled on top of LiveViews.

Developing Keila has been a breeze with the amazing tools from our community.

Here are some of the tools I’m using (on top of the usual suspects like Ecto):

@princemaple’s Swoosh for sending emails with SMTP, SES & Co
@sorentwo’s Oban to ensure reliable email deliveries and scheduling
@edgurgel’s Solid for Liquid templating
@philss’s Floki for HTML manipulation

Right now, I’m getting everything ready for the 0.1 release. If you’re curious about the code, check it out on GitHub:

If you have any questions or suggestions, let me know

Exadra37 · February 11, 2021, 12:39pm

I have not tried it yet but it looks like a very good work you have done here.

I would suggest you to set-up Github sponsors for your project.

crova · February 11, 2021, 1:14pm

Thanks for sharing, I will look at this during the weekend as I would be very keen to collaborate on something like this.

eksperimental · February 11, 2021, 3:06pm

Looks really good. I am reading at your git log --reverse

wmnnd · February 12, 2021, 8:24am

Excellent idea, I will be looking into this! Do you have any experience with GitHub Sponsors so far?

wmnnd · February 12, 2021, 8:25am

Very cool, please feel free to reach out to me personally

Exadra37 · February 12, 2021, 10:00am

No, but see how a developer got to make 100k with Github Sponsors, and one if his projects is a port of LiveView to PHP named LiveWire:

crova · February 12, 2021, 12:10pm

IIRC he began the project with a closed source and then opened it after hitting his target through GH sponsors. It seems that now he offers training material and support for the sponsors (after opening the source code).

It is a nice story to get inspiration from.

wmnnd · February 19, 2021, 2:33pm

Keila v0.1.0 is now out!

The new Markdown editor is powered by LiveView and allows sending of hybrid HTML + Plain Text messages.

From now on, all releases will be available as Docker images on Docker Hub.
There’s now also a Documentation page, so if you want to give Keila a try, here are the installation instructions:
https://keila.io/docs/installation

I hope I’ll find some time to blog about some of the challenges and learnings while building Keila so far. The next blog post will probably be on dynamic Ecto queries, but if you have questions about any particular technical aspect, let me know

wmnnd · July 5, 2021, 12:24pm

Keila 0.5: WYSIWYG, Tracking + Hosted Edition!

Keila 0.5 is now out and there have been a bunch of new features since the last update I posted here!

WYSIWYG editor for campaigns
Send later feature for campaigns
Template editor for creating your own email designs
Campaign open/click tracking
Easier initial setup + improved dark theme

There’s now also a hosted version of Keila available on https://www.keila.io/try.
You can try it for free!

If you’re interested in getting a subscription, feel free to PM me first

Let me know if you have any questions or suggestions! Bug reports and code contributions on GitHub are also always welcome

wmnnd · January 14, 2022, 11:16pm

Keila 0.8: Revamped UI, Segmentation, Custom Contact Data, API

It’s been a while since I posted an update about Keila here, but that’s only because I forgot to update this post

Since 0.5, there have been tons of improvements to Keila, some of the most notable changes are:

Completely revamped UI and dashboard
Contact segmentation
Custom data for contacts
REST API for managing Contacts, Campaigns, Segments

There are also some neat improvements for people running their own Keila instance

Login-as feature for admins
Automated bounce handling with SES
Improved official Docker image
Running Keila in a subdirectory

And of course Keila has also been upgraded to Phoenix 1.6 and is now using heex templates exclusively

The Shiny New UI

The Segment Editor

Where’s the code? Can I contribute?

You can check out the complete code of Keila on GitHub. Bug reports, feature suggestions, and code contributions are very welcome

Is there a demo?

If you want to try Keila in action without installing it, you can check out the managed version for free on keila.io. If you’re interested in getting a subscription, please feel free to PM me.

If you want to install Keila on your own server, check out the installation docs.

GitHub Sponsors

Last but not least, as @Exadra37 suggested in this thread way back in February, you can now also support my work on Keila on GitHub Sponsors

stevensonmt · January 15, 2022, 12:58am

This looks really slick.

maz · February 3, 2022, 2:51pm

Hi, getting this set up and generally got it working. I’m having an issue with keila embedding the port into the Unsubscribe link i.e.:

http://keila.example.com:4040/unsubscribe/p_GX8qGEZd/c_GX8qGEZd

so when the user clicks on it they see:

An error occurred during a connection to keila.example.com:4040. SSL received a record that exceeded the maximum permissible length.

Error code: SSL_ERROR_RX_RECORD_TOO_LONG

I understand that this is an phoenix config setting but I set up using the docker image so I don’t think I can tweak that, or am I wrong? regards,
Michael

stefanluptak · February 3, 2022, 2:56pm

Try removing the url: [port: 4040] setting from the Endpoint configuration, if you have it there.

maz · February 3, 2022, 3:43pm

Thanks for the tip. Yeah I guess I will just have to build my own docker image with that tweak to the endpoint.

wmnnd · February 3, 2022, 4:08pm

The official Keila docker image isn’t set up to handle HTTPS termination - so my recommendation would be to use it behind a reverse proxy like Nginx or Traefik.

wmnnd · February 3, 2022, 4:11pm

Ah, I think I misread your question. You can configure the ports for URL generation via environment variables: Configuration - Keila

PORT determines which port Keila listens to and URL_PORT which port is used for URLs. And in case of ports 80 and 443, this is not included in the generated URLs.

maz · February 3, 2022, 5:58pm

Thanks! Thanks for Keila too.

Change:

URL_PORT=443
URL_SCHEMA=https

were the changes to the config and the url in the unsubscribe link now looks like:
https://keila.example.com/unsubscribe/p_GX8qGEZd/c_GX8qGEZd

I am using Traefik as a proxy. To help out anyone else who’d like to have keila behind Traefik, here is my docker-compose.yml:

version: "3"

services:
  keila:
    image: pentacent/keila:latest
    ports:
      - "4040:4040"
    depends_on:
      - postgres_keila
    build: .
    env_file:
      - .env
    networks:
      - db-network
      - proxy-network
    labels:
      - "traefik.enable=true"
      - "traefik.port=4040"
      - "traefik.http.routers.keila_example-com.entrypoints=http"
      - "traefik.http.routers.keila_example-com.rule=Host(`keila.example.com`)"
      - "traefik.http.middlewares.keila_example-com-https-redirect.redirectscheme.scheme=https"
      - "traefik.http.routers.keila_example-com.middlewares=keila_example-com-https-redirect"
      - "traefik.http.routers.keila_example-com-secure.entrypoints=https"
      - "traefik.http.routers.keila_example-com-secure.rule=Host(`keila.example.com`)"
      - "traefik.http.routers.keila_example-com-secure.tls=true"
      - "traefik.http.routers.keila_example-com-secure.tls.certresolver=http"
      - "traefik.http.routers.keila_example-com-secure.service=keila_example-com"
      - "traefik.http.services.keila_example-com.loadbalancer.server.port=4040"
      - "traefik.docker.network=proxy-network"
  postgres_keila:
    image: postgres:alpine
    ports:
      - "5432:5432"
    environment:
      POSTGRES_PASSWORD: postgres
    networks:
      - db-network

networks:
  db-network:
  proxy-network:
    external: true

Exadra37 · February 3, 2022, 10:44pm

This also exposes the Keila to the world without the need to go through Traefik, because its equivalent to "0.0.0.0:4040:4040". To be only localhost you need to use instead "127.0.0.1:4040:4040", but if the goal is to only have Traefik talking with Keila then you can just simply remove `“4040:4040”.

Regarding Postgres Database you are also exposing it to the world. To communicate with the database from Keila just use the service name postgres_keila has the host on your code, and remove the ports from your docker compose file.

maz · February 3, 2022, 11:24pm

Thanks for the improvements!