Installing Infogami
So you want to run Infogami on your computer? Here's how (more documentation to come).
Requirements
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.
Steps
- 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.
Install mercurial. The documentation is good here too. Be sure to at least read the QuickStart guide so you can set your username. Once you have it, you can install infogami using:
$ hg clone http://infogami.org/src/infogami.devInstall 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.
Postgres
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. 'su postgres').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!
(Edit: What are the steps involved in setting up users and accounts? I'm trying to register, but all I get is a error message saying that the email is already registered. even in the first time I do try to register anything.)
(_Answer:_ That was a bug that seems to be fixed now. Users and accounts should work the first time.)