2019-04-27 15:01:51 +00:00
---
title: FreeBSD
head_inline: "< style > . blue { color : blue ; } < / style > "
---
This guide is based on **FreeBSD Relase 11.1** .
{: .blue}
### Getting MongoDB
---
Install MongoDB with package manager.
```bash
$ sudo pkg install mongodb
```
Run MongoDB server.
```bash
$ mkdir -p ./data/db
$ mongod --dbpath ./data/db
```
### Setting up TUN device (No persistent after rebooting)
---
Configure the TUN device.
```bash
$ sudo ifconfig lo0 alias 127.0.0.2 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.3 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.4 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.5 netmask 255.255.255.255
2020-08-26 03:05:01 +00:00
$ sudo ifconfig lo0 alias 127.0.0.5 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.6 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.7 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.8 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.9 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.10 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.11 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.12 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.13 netmask 255.255.255.255
2019-04-27 15:01:51 +00:00
```
Enable IP forwarding
```bash
$ sudo sysctl -w net.inet.ip.forwarding=1
```
2019-10-27 08:41:14 +00:00
**Tip:** The script provided in [$GIT_REPO/support/network/restart.sh ](https://github.com/{{ site.github_username }}/open5gs/blob/master/support/network/restart.sh ) makes it easy to configure the TUN device as follows:
2019-04-27 15:01:51 +00:00
`$ sudo ./support/network/restart.sh`
{: .notice--info}
2019-10-27 08:41:14 +00:00
### Building Open5GS
2019-04-27 15:01:51 +00:00
---
Install the depedencies for building the source code.
```bash
2020-05-18 21:00:37 +00:00
$ sudo pkg install py36-pip ninja gcc bison gsed pkgconf git mongo-c-driver gnutls libgcrypt libidn libyaml libmicrohttpd curl
2019-04-27 15:01:51 +00:00
```
2019-10-27 08:41:14 +00:00
Install Meson using Python.
```bash
$ sudo pip install --upgrade pip
$ sudo pip install meson
```
Git clone.
2019-04-27 15:01:51 +00:00
```bash
2019-10-27 08:41:14 +00:00
$ git clone https://github.com/{{ site.github_username }}/open5gs
2019-04-27 15:01:51 +00:00
```
2020-08-22 16:44:11 +00:00
To compile with meson:
2019-04-27 15:01:51 +00:00
```bash
2019-10-27 08:41:14 +00:00
$ cd open5gs
$ meson build --prefix=`pwd`/install
$ ninja -C build
2019-04-27 15:01:51 +00:00
```
Check whether the compilation is correct.
**Note:** This should require *sudo* due to access `/dev/tun0` .
{: .notice--danger}
2020-08-22 16:44:11 +00:00
2019-04-27 15:01:51 +00:00
```bash
2020-09-01 04:46:39 +00:00
$ sudo ./build/tests/attach/attach ## EPC Only
$ sudo ./build/tests/registration/registration ## 5G Core Only
2020-08-22 16:44:11 +00:00
```
Run all test programs as below.
**Note:** This should require *sudo* due to access `/dev/tun0` .
{: .notice--danger}
```bash
$ cd build
$ sudo meson test -v
2019-04-27 15:01:51 +00:00
```
2020-11-27 02:44:37 +00:00
**Tip:** You can also check the result of `ninja -C build test` with a tool that captures packets. If you are running `wireshark` , select the `loopback` interface and set FILTER to `s1ap || gtpv2 || pfcp || diameter || gtp || ngap || http2.data.data || http2.headers` . You can see the virtually created packets. [testattach.pcapng ]({{ site.url }}{{ site.baseurl }}/assets/pcapng/testattach.pcapng )/[testregistration.pcapng]({{ site.url }}{{ site.baseurl }}/assets/pcapng/testregistration.pcapng)
2019-04-27 15:01:51 +00:00
{: .notice--info}
2020-08-22 16:44:11 +00:00
You need to perform the **installation process** .
2019-04-27 15:01:51 +00:00
```bash
2019-10-27 08:41:14 +00:00
$ cd build
$ ninja install
2020-08-22 16:44:11 +00:00
$ cd ../
2019-04-27 15:01:51 +00:00
```
2019-10-27 08:41:14 +00:00
### Building WebUI of Open5GS
2019-04-27 15:01:51 +00:00
---
2019-10-27 08:41:14 +00:00
[Node.js ](https://nodejs.org/ ) is required to build WebUI of Open5GS
2019-04-27 15:01:51 +00:00
```bash
$ sudo pkg install node
```
Install the dependencies to run WebUI
```bash
2019-10-27 08:41:14 +00:00
$ cd webui
$ npm install
2019-04-27 15:01:51 +00:00
```
The WebUI runs as an [npm ](https://www.npmjs.com/ ) script.
```bash
2019-10-27 08:41:14 +00:00
$ npm run dev
2019-04-27 15:01:51 +00:00
```