Installing OneGate is very straightforward, and involves a few simple steps.

OneGate's main program, onegate, should reside in a directory that has CGI execution enabled in your httpd configuration. The program's working directory, also called onegate should reside somewhere outside of the web document space on your server for reasons of security.

If you are installing on *nix, make sure you log in as or su to the same user as should be running onegate, prior to installation or any (re)confguration. If you do not, you will need to manually adjust permissions and ownerships accordingly.

To install OneGate, follow these steps:

1. Copy the distribution tarball to a directory where you have write permission.

2. Untar the distribution tarball.

3. Change directory into onegate-install.

4. Run perl ./install.pl to begin the installation process.

5. Answer the location questions.

6. Adjust the ownership of the files and directories under OneGate's directory tree if necessary. (See Dealing with UID Conflicts in this documentation for a more thorough explanation.)

7. Proceed to the section on configuration.