How to Install

How to get TacoNET up and running

Here are some quick directions on how to get TacoNET up and running. See [Configuring TacoNET] to actually make it do something.

Windows

Once we're out of alpha, we'll make a windows installer but until then, you'll need to download and install:

• Python
  • Quick Download Link -- (Valid on April 12th, 2013)
• Pycrypto
  • Quick Download Link -- (Valid on April 12th, 2013)
• Recommended: TortoiseSVN -- As we are currently in alpha, we are making constant updates. TortoiseSVN will make it easy to acquire the newest version of the source code. We don't plan to make install packages or tarballs until beta.

Install Python and Pycrpto, and optionally TortoiseSVN. They are simple installs. Just download, run and click Next for awhile and you're done.

Now that you have Python, Pycrypto and TortoiseSVN installed, you'll want to create a directory to house the TacoNET source code. Once you have done that, right click on the folder and select SVN Checkout... from the pop up menu. This will present you with an SVN Checkout window. The URL of repository should be

svn://svn.code.sf.net/p/taconet/code/trunk

All the other settings can be left defaults. Click OK. You'll see TacoNET files being downloaded. Once this is done, click OK. Now, open the folder you created, you should see some files and folders. Double click on taconet.py. A console window should open up, and some debug text will occasionally output in it. Feel free to minimize this window, we how no mechanism to run TacoNET as a service or daemon in windows yet, we plan to for beta. You should regularly shut down TacoNET and right click on this folder and select SVN Update to get the newest version of the source code. Once we are in beta, installation packages will be provided.

Point your web browser to http://localhost:9002/. You should see the TacoNET Home page. If you don't, try looking at the section [Tweaking The TacoNET Config File] for helpful info.

Linux

Linux user eh? Good call. TacoNET is much easier to get installed on linux.

Chances are you already have python, Python 2.6.6 or newer is required. Use your package manager of choice to get Python 2.6.6 or newer installed if it isn't already. To check what python version you have, you can type:

$ python --version
Python 2.6.6

If those numbers are less than 2.6.6, you'll need to get a newer version of python installed. Sometimes it could also just be your os defaulting to a older version. You can do a:

$ find /usr/bin -type f -iname "python*"
/usr/bin/python2.6
/usr/bin/python2.6-config

If you see a newer version in the list, you can use that full python in place of just typing "python".

You'll also need the python-crypto and subversion packages. You will want the screen package as well, as TacoNET doesn't run as a daemon yet.

For example (on debian variants):

tacoscott@debian:~$ sudo apt-get install python-crypto subversion screen

Let those install, and then create yourself a directory that will house the source code for TacoNET. Then checkout the newest version of the source code. Until we are in beta, the newest version will be what you should be using.

For example:

tacoscott@debian:~$ mkdir TacoNET
tacoscott@debian:~$ cd TacoNET
tacoscott@debian:~/TacoNET$ svn checkout svn://svn.code.sf.net/p/taconet/code/trunk .

You'll see some file names fly by, that's normal. Now if you do a directory listing you'll see something like this:

tacoscott@debian:~/TacoNET$ ls
total 172
bottle.py  cherrypy  static  taco  taconet.py  templates

You are now ready to run TacoNET for the first time by invoking:

tacoscott@debian:~/TacoNET$ screen -dmS TacoNET "python taconet.py"

This will launch TacoNET in a screen session, allowing the process to persist after logging out. You could also choose to run it in the foreground if you wish. To run TacoNET in the foreground, try:

$ python taconet.py

Running it in the foreground will generate a bunch of debug information, this will be reduced, removed or obscured in future releases.

Point your web browser to http://localhost:9002/. You should see the TacoNET Home page. If you don't, try looking at the section [Tweaking The TacoNET Config File] for helpful info.

You should regularly shut down TacoNET and "svn up" in this folder to get the newest version of the source code. Once we are in beta, tarballs will be provided.

MacOS

I have no idea. Similar to linux instructions somewhat I suppose.