Belenios is written in OCaml and has some dependencies towards third-party OCaml libraries. The easiest and most portable way to compile Belenios from source is to use OPAM, which is a package manager for OCaml projects.
The non-OCaml prerequisites are:
These libraries and tools are pretty common, and might be directly part of your operating system. On Debian and its derivatives, they can be installed with the following command:
apt-get install build-essential libgmp-dev libpcre3-dev pkg-config m4 libssl-dev libsqlite3-dev wget ca-certificates unzip aspcud libncurses-dev uuid-runtime
If you are unfamiliar with OCaml or OPAM, we provide an
opam-bootstrap.sh shell script that creates a whole, hopefully
self-contained, OCaml+OPAM install, and then installs all the
dependencies of Belenios, everything into a single directory. You can
choose the directory by setting the
variable, or it will take
~/.belenios by default. Just run:
On a modern desktop system, this needs approximately 10 minutes and 1 gigabyte of disk space.
If everything goes successfully, follow the given instructions to update your shell environment, then run:
and you can skip the next two sections and go directly to the Documentation section.
If you are familiar with OCaml, please read the
shell script, or the following two sections to compile Belenios with
your existing OCaml installation.
To compile the command-line tool, you will need:
With OPAM, these dependencies can be installed with the following command:
opam install atdgen zarith cryptokit uuidm calendar cmdliner
Once all the dependencies have been installed, the command-line tool can be compiled with:
It produces a single executable,
belenios-tool, in the
directory. You can install it in your
PATH (which we will assume in
the guides), or refer to it with a full path.
The web server has the following additional dependencies:
With OPAM, you can install them with:
opam install eliom csv
Once all the dependencies have been installed, the Eliom module can be compiled with:
It will produce a single Eliom module,
server.cma, in the
_build/src/web directory. See
demo/ocsigenserver.conf.in for an
ocsigenserver configuration template, and the Server administrator's
guide for more information on how to use it.
To generate HTML files from
.md ones, you will need:
Additionnaly, you will need LaTeX to compile the specification.
On Debian-based systems, you can install the dependencies needed to compile the documentation with:
sudo apt-get install markdown texlive
Once all the dependencies have been installed, the documentation can be compiled with:
At the time of writing (05 Apr 2016), you need the development version of Debian (or Ubuntu) to be able to compile Belenios using only official Debian packages. On Ubuntu, you need to enable the "Universe" repository. Instead of using OPAM, the dependencies of Belenios can then be installed with:
sudo apt-get install libatdgen-ocaml-dev libzarith-ocaml-dev libcryptokit-ocaml-dev libuuidm-ocaml-dev libcalendar-ocaml-dev libcmdliner-ocaml-dev sudo apt-get install ocsigenserver eliom libcsv-ocaml-dev
Windows is not yet a fully supported platform, but you can compile at least the command-line tool on Windows + 32-bit Cygwin. You might need the following packages:
With these packages installed, you should be able to install OPAM by following its installation instructions from sources. Once OPAM is installed, follow the instructions in the Command-line tool section above.
OCamlDuce is an optional transitive dependency of Belenios, but Belenios does not use it. If OCamlDuce was installed outside of OPAM (e.g. via your system package manager), you may face issues. You can work around them by uninstalling OCamlDuce and restarting the installation procedure.
The instructions outlined in this document and in the
opam-bootstrap.sh script imply downloading files from third-party
servers. Sometimes, these servers can be down. For example, you can
=-=-= Installing ocamlnet.3.7.3 =-=-= ocamlnet.3.7.3 Downloading http://download.camlcity.org/download/ocamlnet-3.7.3.tar.gz [ERROR] http://download.camlcity.org/download/ocamlnet-3.7.3.tar.gz is not available ===== ERROR while installing ocamlnet.3.7.3 ===== Could not get the source for ocamlnet.3.7.3.
This can be worked around with the following steps:
env.shfile (you must adapt it if you use an incompatible shell such as tcsh);
opam pin <package-name> <path-to-file-download-above>(in the example above,
opam installcommand found in
If ocsigenserver fails to install because of a SSL-related error:
An alternative could be to install aspcud before running
If you succeeded installing all dependencies, but you get errors while
compiling Belenios, maybe you installed an incompatible version of a
opam-bootstrap.sh script is tuned to install only
compatible versions; you can have a look at it to get these versions.