How to Deploy a Phoenix App to Gigalixir in 20 Minutes

November 06, 2020 • 1 minute read

This is a quick screencast to demonstrate how easy it is to deploy an Elixir application to Gigalixir, a hosting platform built specifically for Elixir.

I included a condensed text version of the video for those who prefer it, but you can find the full guide here.

Create the Phoenix App

# install the generator
$ mix archive.install hex phx_new 1.5.6

# generate the project
$ mix foobar

# cd into the directory
$ cd foobar

# create our database
$ mix ecto.create

# start the server
$ mix phx.server

# commit your code to git
$ git init && git commit -am 'Initial Commit'

Prod Configuration

You will have to adjust some prod configuration for our app to work on Gigalixir. Let’s make the following adjustments to the config/prod.exs file.

  config :foobar, FoobarWeb.Endpoint,
-   url: [host: "", port: 80],
+   url: [host: "", port: 443],
-   cache_static_manifest: "priv/static/cache_manifest.json"
+   cache_static_manifest: "priv/static/cache_manifest.json",
+   force_ssl: [rewrite_on: [:x_forwarded_proto]]
+ config :foobar, Foobar.Repo,
+   ssl: true

Deploy to Gigalixir

# install gigalixir (using Homebrew)
$ brew tap gigalixir/brew && brew install gigalixir

# sign up for gigalixir
$ gigalixir signup

# log in to gigalixir
$ gigalixir login

# create the app
$ gigalixir create

# set up your buildpacks
$ echo "elixir_version=1.10.3" > elixir_buildpack.config
$ echo "erlang_version=22.3" >> elixir_buildpack.config
$ echo "node_version=12.16.3" > phoenix_static_buildpack.config

# commit those changes
$ git commit -am 'Set up gigalixir buildpacks'

# create your prod database
$ gigalixir pg:create --free

# deploy your app
$ git push gigalixir main

# open your prod app
$ gigalixir open

If you want to stay current with what I'm working on and articles I write, join my mailing list!

I seldom send emails, and I will never share your email address with anyone else.