Skip to content

Latest commit

 

History

History
121 lines (82 loc) · 3.1 KB

INSTALL.md

File metadata and controls

121 lines (82 loc) · 3.1 KB

Linux

You need the following things installed. (Will vary by distribution).

  • Python (2.7+)
  • python-virtualenv
  • pip
  • build-essential
  • python-devel (for CentOS, RHEL, Fedora) / python-dev (for Debian, Ubuntu, Mint)

Following are the steps to install the above dependencies for few major distributions.

For CentOS, RHEL, Fedora

sudo yum install python python-pip python-devel
pip install virtualenv

For Debian, Ubuntu, Mint

sudo apt-get install python python-pip build-essential python-dev
pip install virtualenv

There are two ways to install and setup dtella on a Linux system, the first using Virtual Environments is cleaner and recommended.

Virtual Environments

Do the following

cd ~ # Or go to some other suitable folder
virtualenv dtella && cd $_ && . bin/activate;
git clone https://github.com/ffledgling/dtella.git src
pip install -v twisted PyCrypto dnspython gdata

This installs the python dependencies required.

System Level install

The following Python libraries need to be installed at the system level:

  • Twisted
  • PyCrypto
  • gdata
  • dnspython

You can do this using sudo pip install or your distribution's package manager.

Then do the following:

cd ~ # Or go to some other suitable folder
git clone https://github.com/ffledgling/dtella.git src

This takes care of downloading the source code.

Running dtella

From within the same terminal (i.e from within the active virtualenv), do the following:

cd src && ./dtella.py

This should start the dtella server in that tab.
Then simply follow the instructions given in the README.md to connect to the hub.

Mac OSX

This method assumes you have brew installed.

brew install python # This should pull in pip
sudo pip install virtualenv
cd ~ # Or go to some other suitable folder
virtualenv dtella && cd $_ && . bin/activate;
git clone https://github.com/ffledgling/dtella.git src
pip install -v twisted PyCrypto dnspython gdata

This completes the dependencies required. From within the same terminal, do the following:

cd src && ./dtella.py

This should start the dtella server in that tab.
Then simply follow the instructions given in the README.md to connect to the hub.

Windows

Avoid using this Operating System when given the choice. It'll probably be slow, the network libraries are subpar.

  1. Download the setup file from the Releases Section and run it.

  2. If you get a warning message stating that the package is from an "Unkown Publisher", just click on "More Info" and then "Continue Anyway".

  3. After the installation is complete, the Windows Firewall will ask you whether you want to allow dtella to communicate using your public and private network. Allow both the options and continue.

  4. Then go to the folder where you have installed dtella and run dtella.exe. This will run dtella in the background.

  5. Follow README.md for instructions on how to connect your DC client to the Hub.

Side Note: The brave of heart can try building dtella from source (after installing the dependencies, of course).