From c279eee663c376e9f9f032057e247eaf6023c203 Mon Sep 17 00:00:00 2001 From: Dimitri Staessens Date: Sat, 13 Feb 2021 17:17:15 +0100 Subject: content: Merge getting started into single page --- content/en/docs/Start/_index.md | 216 ++++++++++++++++++++++++++++++++++ content/en/docs/Start/check.md | 85 ------------- content/en/docs/Start/download.md | 28 ----- content/en/docs/Start/install.md | 57 --------- content/en/docs/Start/requirements.md | 76 ------------ 5 files changed, 216 insertions(+), 246 deletions(-) delete mode 100644 content/en/docs/Start/check.md delete mode 100644 content/en/docs/Start/download.md delete mode 100644 content/en/docs/Start/install.md delete mode 100644 content/en/docs/Start/requirements.md (limited to 'content') diff --git a/content/en/docs/Start/_index.md b/content/en/docs/Start/_index.md index 963b9f1..43d8e28 100644 --- a/content/en/docs/Start/_index.md +++ b/content/en/docs/Start/_index.md @@ -5,3 +5,219 @@ weight: 20 description: > How to get up and running with the Ouroboros prototype. --- + +### Get Ouroboros + +**Packages:** + +For ArchLinux users, the easiest way to try Ouroboros is via the [Arch +User Repository](https://aur.archlinux.org/packages/ouroboros-git/), +which will also install all dependencies. + +**Source:** + +You can clone the [repository](/cgit/ouroboros) over https or +git: + +```bash +$ git clone https://ouroboros.rocks/git/ouroboros +$ git clone git://ouroboros.rocks/ouroboros +``` + +Or download a [snapshot](/cgit/ouroboros/) tarball and extract it. + +### System requirements + +Ouroboros builds on most POSIX compliant systems. Below you will find +instructions for GNU/Linux, FreeBSD and OS X. On Windows 10, you can +build Ouroboros using the [Linux Subsystem for +Windows](https://docs.microsoft.com/en-us/windows/wsl/install-win10) . + +You need [*git*](https://git-scm.com/) to clone the +repository. To build Ouroboros, you need [*cmake*](https://cmake.org/), +[*google protocol buffers*](https://github.com/protobuf-c/protobuf-c) +installed in addition to a C compiler ([*gcc*](https://gcc.gnu.org/) or +[*clang*](https://clang.llvm.org/)) and +[*make*](https://www.gnu.org/software/make/). + +Optionally, you can also install +[*libgcrypt*](https://gnupg.org/software/libgcrypt/index.html), +[*libssl*](https://www.openssl.org/), +[*fuse*](https://github.com/libfuse), and *dnsutils*. + +On GNU/Linux you will need either libgcrypt (≥ 1.7.0) or libssl if your +[*glibc*](https://www.gnu.org/software/libc/) is older than version +2.25. + +On OS X, you will need [homebrew](https://brew.sh/). +[Disable System Integrity Protection](https://developer.apple.com/library/content/documentation/Security/Conceptual/System_Integrity_Protection_Guide/ConfiguringSystemIntegrityProtection/ConfiguringSystemIntegrityProtection.html) +during the +[installation](#install) +and/or +[removal](#remove) +of Ouroboros. + +### Install the dependencies + +**Debian/Ubuntu Linux:** + +```bash +$ apt-get install git protobuf-c-compiler cmake +$ apt-get install libgcrypt20-dev libssl-dev libfuse-dev dnsutils cmake-curses-gui +``` + +If during the build process cmake complains that the Protobuf C +compiler is required but not found, and you installed the +protobuf-c-compiler package, you will also need this: + +```bash +$ apt-get install libprotobuf-c-dev +``` + +**Arch Linux:** + +```bash +$ pacman -S git protobuf-c cmake +$ pacman -S libgcrypt openssl fuse dnsutils +``` + +**FreeBSD 11:** + +```bash +$ pkg install git protobuf-c cmake +$ pkg install libgcrypt openssl fusefs-libs bind-tools +``` + +**Mac OS X Sierra / High Sierra:** + +```bash +$ brew install git protobuf-c cmake +$ brew install libgcrypt openssl +``` + +### Install Ouroboros + +We recommend creating a build directory: + +```bash +$ mkdir build && cd build +``` + +Run cmake providing the path to where you cloned the Ouroboros +repository. Assuming you created the build directory inside the +repository directory, do: + +```bash +$ cmake .. +``` + +Build and install Ouroboros: + +```bash +$ sudo make install +``` + +### Advanced options + +Ouroboros can be configured by providing parameters to the cmake +command: + +```bash +$ cmake -D