-
Notifications
You must be signed in to change notification settings - Fork 5
Installing From Source
These instructions assume a basic knowledge of Linux/Unix and command-line tools.
open890 is currently supported under Linux, or Unix-like operating systems like MacOS. You can also follow these instructions in Windows 10 if you have WSL installed - much of this project was written under WSL.
If you are on Windows and do not have WSL installed, you can still compile the app, assuming you have the Windows versions of Elixir and NodeJS installed. See Developing on Windows for more information.
You will need Elixir (and thus, Erlang) and NodeJS installed, particularly if you are either developing features for open890, or using a non-binary (e.g. source) release.
Using a tool like asdf is recommended to manage the various versions of the development dependencies.
-
Install erlang, elixir and nodeJS plugins
asdf plugin add erlang https://github.com/asdf-vm/asdf-erlang.git asdf plugin-add elixir https://github.com/asdf-vm/asdf-elixir.git asdf plugin-add nodejs https://github.com/asdf-vm/asdf-nodejs.git
-
At this point, Raspberry Pi users may need to install the following packages:
sudo apt -y install autoconf libssl-dev libncurses5-dev
-
Install the specific versions listed in the
.tool-versions
file:bash -c '${ASDF_DATA_DIR:=$HOME/.asdf}/plugins/nodejs/bin/import-release-team-keyring' asdf install
-
The Erlang install will take a very long time on a Raspberry Pi. You may also see scary-looking messages during the Erlang install that says something like "fop is missing" or "documentation cannot be built" - this is OK.
-
Once everything has installed, you should be able to run
elixir --version
and alsonpm --version
git clone https://github.com/tonyc/open890.git
cd open890
There are two main branches in the repository: main
and develop
-
main
can be interpreted as "stable", but unreleased. Code that lands in main is next in line for a release. This is the default branch you get when cloning the repository. -
develop
should be considered "unstable". Things may break, things may change around rapidly, etc.
To check out the develop
branch:
git checkout develop
-
Install dependencies with
mix deps.get
. First-time users may need to answerY
to a couple of prompts -
Compile with
mix compile
-
Once that's finished, compile assets:
cd assets/ npm install cd ..
- Run
mix phx.server
Now you can visit http://localhost:4000
from your browser.
Type ^C^C
(aka: ctrl-c twice)