Skip to content

Latest commit

 

History

History
136 lines (85 loc) · 3.18 KB

Linux.md

File metadata and controls

136 lines (85 loc) · 3.18 KB
Raw

Build qaul.net release-1.0.0 on Debian Linux

This tutorial describes all the steps to build qaul.net on a Debian Linux distro. It has been tested on the following distributions:

  • Debian
  • Ubuntu
  • Linux Mint
  • Arch Linux
  • Manjaro

Prerequesites

Install needed software to download and build qaul.net from Source.

For Debian based linux distributions, run the following commands:

sudo apt-get install git cmake build-essential pkg-config \
libgtk-3-dev  libwebkit2gtk-4.0-dev libdbus-1-dev autotools-dev \
libasound2-dev bison flex automake

For Arch Linux, run the following commands:

sudo pacman -S autoconf automake git cmake pkg-config \
gtk3 dbus bison flex dbus webkit2gtk

For Manjaro, run the following commands:

pamac autoconf automake git cmake pkg-config \
gtk3 dbus bison flex dbus webkit2gtk

For Fedora(Redhat distros) Linux, run the following commands.

sudo dnf groupinstall "Development Tools" "Development Libraries" \
autoconf automake git cmake pkg-config gtk3 dbus bison flex dbus alsa-lib-devel

Download and Build

# Download the source from https://github.com/qaul/qaul.net, checkout 
# branch release-1.0.0, download and init submodules
git clone --recursive --branch release-1.0.0 https://github.com/qaul/qaul.net.git

# create build directory
cd qaul.net
mkdir build
cd build

# generate make files
cmake ..

# make and install qaul.net
make
sudo make install

Troubleshooting

CMAKE Failure

cmake needs to be of a version 3.1 or higher to be able to run sucessfully.

Debian Wheezy and Debian Jessie

On debian wheezy and debian jessie one needs to install cmake from wheezy-backports.

Add the following line to the file /etc/apt/sources.list to be able to use the wheezy-backports repository

deb http://ftp.de.debian.org/debian/ wheezy-backports main non-free

Install the cmake version from backports

# update the package list
sudo apt-get update
# install cmake from wheezy-backports
sudo apt-get -t wheezy-backports install cmake
Ubuntu Trusty

Install cmake from ppa

# add ppa
sudo add-apt-repository ppa:george-edison55/cmake-3.x
# install newer CMAKE
sudo apt-get update
sudo apt-get install cmake
Debian Wheezy
Make error

Make fails to build portfwd due to missing execution permissions for bootstrap. Add the permissions to bootstrap:

chmod +x third_party/portfwd/src/portfwd/bootstrap

Run qaul.net GUI client

Run qaul.net GKT client from the command line

# run qaul.net GUI client form the command line	
/opt/qaul/bin/qaul-gtk

Run qaul.net GUI client

Run qaul.net GKT client from the command line

# run qaul.net GUI client form the command line	
/opt/qaul/bin/qaul-gtk

Create the .deb Installer package

To create the .deb installer, execute the following command in your build directory.

make package

# if you have run `sudo make install` before running `make package`
# you may need to delete some files created with root permissions
# first. You may find these files executing the follwing command:
## find . -user root