Skip to content


By the end of this guide you should have a working ExVenture development environment.



You should install Git via your platform's package manager.


You should install PostgreSQL via your platforms package manager or for Mac.


sudo apt install postgresql

For Arch, following the wiki on installing PostgreSQL.

Ensure a superuser is enabled for your login name.

sudo -u postgres createuser --superuser `whoami`

PostgreSQL Authentication

By default ExVenture will try ident based authentication. You may need to alter your hba.config settings to allow this. This is only recommended for development.

# IPv4 local connections:
host    all             all               trust
# IPv6 local connections:
host    all             all             ::1/128                 trust

Elixir / Erlang

The easiest way to get Erlang/Elixir going is to install asdf. You can follow their install guide on the README. Below is the Ubuntu bash set up for reference.

git clone ~/.asdf --branch v0.4.0
echo -e '\n. $HOME/.asdf/' >> ~/.bashrc
echo -e '\n. $HOME/.asdf/completions/asdf.bash' >> ~/.bashrc

After installing asdf make sure to reload your terminal by opening a new tab or sourcing your bashrc file again, source ~/.bashrc.

Before installing Elixir you need to install Erlang. It may also require development headers to be in place depending on your system.

Ubuntu (taken from asdf-erlang):

sudo apt install build-essential autoconf m4 libncurses5-dev libwxgtk3.0-dev libgl1-mesa-dev libglu1-mesa-dev libpng3 libssh-dev unixodbc-dev

Install Erlang via asdf.

asdf plugin-add erlang
asdf install erlang 20.1
asdf global erlang 20.1

Install Elixir via asdf.

asdf plugin-add elixir
asdf install elixir 1.6.1
asdf global elixir 1.6.1
mix local.hex
mix local.rebar


Install node.js via asdf.

asdf plugin-add nodejs
bash ~/.asdf/plugins/nodejs/bin/import-release-team-keyring
asdf install nodejs 8.8.1
asdf global nodejs 8.8.1

You will also need python for node-sass:


sudo apt install python


With requirements set up we can start to get ExVenture going. These commands will set up the elixir side:

git clone
cd ex_venture
mix deps.get
mix compile

To get assets set up, which uses brunch:

cd assets
npm install
node node_modules/brunch/bin/brunch build
cd ..

Next get the database set up:

mix ecto.create
mix ecto.migrate
mix run priv/repo/seeds.exs

With that the app is up and running. You can boot it with:

mix run --no-halt

And connect via telnet on 5555 and via web on 4000. Both of these are configurable via the file config/dev.exs.

If you have tintin++ installed you can connect with:

tt++ -G local.tin

The local.tin tintin script sets up base GMCP and can turn debug mode on my removing a nop on config {debug telnet} {on}.


To run tests you need to set up the test database first:

MIX_ENV=test mix ecto.create
MIX_ENV=test mix ecto.migrate

Once that is in place you can run tests with:

mix test