So you want to run Infogami on your computer? Here's how (more documentation to come).
A computer with any POSIX-compatible OS (unix, linux, BSD, etc.). Infogami has been successfully run on the following systems: Debian, Ubuntu, Mac OS X.
- Install web.py . You may also want to read the documentation at webpy.org, as it's quite helpful. This also assumes you have already installed Python.
You don't need to use anything in the 'Production' section of web.py's installation guide if you only want to run Infogami on your local machine. If you want to use it for larger projects you may have to do some further reading.
$ hg clone http://infogami.org/hg/ infogami
Install a database system. Infogami is currently compatible with postgres. You may also need to install the python package for postgres (python-psycopg).
Set up your database tables. Table definitions can be found in the infogami/tdb/schema.sql folder. Once your database program has been installed, create a database and set up the tables.
createdb infogami psql infogami < infogami/tdb/schema.sql
Create a 'run.py'. This is the file you will run using web.py to launch Infogami. Create a new file in your /site/infogami folder and type
import infogami infogami.config.db_parameters = dict(dbn='postgres', db="infogami", user='yourname', pw='') #use your settings infogami.config.site = 'sitename.local' if __name__ == "__main__": infogami.run()
You can also find sample_run.py in the infogami codebase.
Install infogami. Once you have your run.py set up, just type
python run.py install. Depending on your database permissions and configurations, you may need to do this as a user who has access to the database (e.g. '
Run infogami. Type 'python run.py'. Just like running anything with web.py, you should see output that looks like 'http://localhost:8080/'. Visit that site in your web browser to see your infogami installation!