View Source Installation

Objective

Install Beacon and Beacon LiveAdmin in a new Phoenix LiveView application to enable running and managing sites.

Notes

  • If you already have a Phoenix LiveView application that meets the minimum requirements for Beacon and Beacon LiveAdmin, you can skip to "Install in an existing application".
  • Beacon LiveAdmin can be installed in a separate application in a cluster environment but such advanced setup is not covered in this guide.

Steps

  1. Setup a PostgreSQL database server

Make sure it's installed and running.

Currently, only PostgreSQL is supported.

  1. Install Elixir v1.14 or later

Check out the official Elixir install guide for more info.

Install as a new application

If you're starting a new project, you can follow these steps to generate a new Phoenix application with Beacon and Beacon LiveAdmin installed. Otherwise, skip to the next section to install Beacon in an existing application.

  1. Update Hex
mix local.hex
  1. Install or update Phoenix and Igniter Installers
mix archive.install hex phx_new
mix archive.install hex igniter_new

Check out the official Phoenix install guide for more info.

  1. Generate the new application
mix igniter.new my_app --install beacon,beacon_live_admin --with phx.new

Replace my_app with the name of your application and follow the prompts.

Install in an existing application

Follow these steps to install Beacon and Beacon LiveAdmin in an existing Phoenix application.

  1. Add the Igniter dependency in your project mix.exs file:
defp deps do
  [
    {:igniter, "~> 0.4"}
  ]
end
  1. Install dependencies
mix deps.get
  1. Install Beacon and Beacon LiveAdmin
mix igniter.install beacon,beacon_live_admin

Next Steps

Beacon is installed but you have no sites yet. Follow the Your First Site guide to set up one and get familiar with Beacon.