Littlechat
A group video chat application built with Phoenix, LiveView, and WebRTC. Want a step-by-step on how it was made? Check out this blog post.
Development Environment Setup
To start your Phoenix server:
- Install dependencies with
mix deps.get- You may have trouble installing
stundue to OpenSSL. If so, you'll want to set your headers in your environment. Try this GitHub issue comment for a fix.
- You may have trouble installing
- Create and migrate your database with
mix ecto.setup - Install Node.js dependencies with
npm installinside theassetsdirectory - Start Phoenix endpoint with
mix phx.server
Now you can visit localhost:4000 from your browser.
Deployment
Littlechat is configured to use distillery for deployments. We previously had instructions here for easy deployment with Gigalixir, but unfortunately, Gigalixir doesn't allow us to open UDP port 3478 for incoming traffic, which prevents our STUN server (and thus ICE negotiation) from working. We currently run Littlechat on a Digital Ocean box, and it works great!
Building a Release
To build a release using distillery, run the bin/release script.
Deploys on Gigalixir are not supported because it is not possible to open a port other than 80 or 443 on Gigalixir - so it's not possible to run the STUN server.
The main thing you'll want to watch out for in deployments is that most browsers require HTTPS for WebRTC unless you're at localhost, so make sure you're using HTTPS.
If you'd rather deploy on your own box, you'll just need to adjust some of the values in prod.exs accordingly and you'll be on your way.