Docker Phoenix

Prerequisites

Install docker and docker-compose. Duplicate .example.env file and rename it to .env

Motivation

I wanted to have a starter kit for Phoenix projects that I would be able to run anywhere in docker. Alpine linux is used for all the docker images. If you use vscode - all the necessary extensions for developing phoenix application will be installed automatically inside the container

Set up for vscode users

1. Install https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack
2. Open the folder in vscode and it should suggest you to reopen it inside the container
3. After setting up the database (see the Get Started section to learn about that) you can add connection in postresql explorer. Use hostname db, user and password from .env file. If this doesn't work make sure gnome-keyring and libsecret are installed.
4. In devcontainer.json set elixir.projectPath and elixirLS.projectDir to the path to your project so elixir-ls extension starts working.

Get started

1. Start shell session inside the container. For vscode users - just open the terminal (Ctrl + J) - it will already be inside the container. For others - run e.g. docker exec -it phoenix-docker_app_1 sh
2. Create new phoenix project mix phx.new your_project_name and press enter to install dependencies when it prompts you
3. To set up postgres open config/dev.exs, change hostname to "db", database to "database" and run mix ecto.create in your project folder
4. Run iex -S mix phx.server

Open browser on localhost:4000