The nix package manager works on linux & mac, and ensures our app and its dependencies are exactly the same across machines (at the byte-level) by using a system of determinstic builds and input hashing. Using it is the fastest way to get all the needed packages on your machine. Install it with:
https://nixos.org/download.html
You might need to restart your shell or edit your PATH after the install (just follow the prompts).
Running nix-shell in this directory will fetch all the project's dependencies
and (while you're in the shell) add them to your PATH. This is not a
container, it's just a fancy shell environment. On first run it will take a
minute to download everything, so I find it eaiser to make it verbose:
nix-shell --verbose
If you have direnv, you can activate this shell every time you enter it in
the terminal. To enable this, install direnv
and run direnv allow in this directory.
Elixir is installed and setup via nix-shell, so install this project's packages using:
mix deps.get
You can do this a few ways, the first is to run:
./db.sh start
./db.sh stop # when you're done with itThis is what I do, but it's a bit hacky. Another way is with docker-compose:
sudo docker-compose -f docker-compose.yaml up # start
sudo docker-compose -f docker-compose.yaml down # stopNow that the database is running, we can create our tables:
mix ecto.setup
Elixir will launch your app and put you in a REPL inside the app's context:
iex -S mix phx.server
Now you can visit localhost:8989 from your browser.