Install from sources

This tutorial explains how to install neubot from sources, assuming you have already downloaded the sources archive.

Note that in this page we assume that you have downloaded version 0.4, but, of course, you should adapt the commands to match the version number of the archive you have downloaded.

If you read this tutorial you might also want to read how to uninstall neubot once you installed it from sources.


Unix

With Unix you can either install neubot or run neubot in-place from sources directory. Here are the commands to install neubot on Debian, other Unixes may require different commands (especially for creating user and group). If in doubt, check the manuals of your system:

Install neubot

  1. Make sure that Python >= 2.5 and python -V

    This command should output something like: Python 2.6.5. If Python is not installed you should manage to install it using the proper tools of your Unix distribution.

  2. Unpack the sources archive: tar -xzf neubot-0.4.tar.gz

  3. Enter the sources directory: cd neubot-0.4

  4. Become root: su or sudo -s

    The right command to become root depends on the policy of your Unix distribution. The traditional command to become root has always been su. But Ubuntu, and MacOsX (and possibly others) require you to use sudo.

  5. Install neubot: make install

  6. Add neubot group: groupadd -r _neubot

  7. Add neubot user: useradd -r -d/ -g_neubot -s/usr/sbin/nologin _neubot

  8. Start neubot daemon: /usr/local/bin/neubot start

    Neubot will become a daemon, will drop root privileges, and will run on behalf of the _neubot user and group, periodically performing transmission tests.

  9. Automatically start neubot daemon at startup.

    Assuming that Python is at /usr/local/bin/python, add the following code snippet to /etc/rc.local:

    /usr/local/bin/python /usr/local/bin/neubot start
    
  10. Exit from the root shell: exit

  11. Open the web user interface and provide privacy permissions.

Windows

See FAQ 2.4.