Requirements
To install Decapod 0.6, you will need to satisfy the following requirements:
Required:
- Ubuntu 12.04 (32 bit or 64 bit)
- Firefox 12 or later
- Decapod application (including OCRopus and Fluid Infusion elements)
Recommended:
- A display capable of 1280x1024 pixels.
Installation Procedure
You will need Mercurial to access the Decapod code repository. You can install Mercurial by running sudo apt-get install mercurial
If you are using Mercurial v1.7.4+ you may need to set the hostfingerprints.
For instructions and an example of setting the fingerprint, please refer to this: Setting Host Fingerprints for Mercurial.
In a terminal, run the following:
hg clone https://decapod.googlecode.com/hg/ -r decapod-0.6 decapod-0.6 cd decapod-0.6/install-scripts/ sudo ./decapod-all.sh
The above commands will retrieve the 0.6 release of the Decapod source code.
Note: the Decapod 0.6 tag may not appear in the cloned source (see: http://mercurial.selenic.com/wiki/Tag)
To Run Decapod for the First Time
Assuming your current directory is ./decapod-0.6/
, enter the following in a terminal:
cd decapod-server/ python ./decapod.py
Once the server is running, open a web browser sessions using the following URL: http://localhost:8080/
Troubleshooting
"<Some file> not found." Error
Try running through the installation steps again as shown above.
"./library/book/images... Permission denied" Error when running Decapod 0.6 server
You may need to change the permissions on the decapod-server/book directory. Alternatively, you can try running Decapod using sudo python ./decapod.py
If you start the server using sudo, you will always have to run it with sudo, as the permissions of the created directories will be restricted by it.