Quick Installation Guide

Below is a step by step walktrough of the installation process. It's pretty simple and straight forward. You can either walk throught it sequentially or hit the quick links to skip to the juicy bits. If you're having problems, visit our documentation pages to see if your problem has already been addressed. If not, please, .

System Requirements

Installation and Configuration

  1. Make sure you have PERL installed.
  2. Untar the package.
  3. Make sure easypass.pl is pointing to the correct location for PERL.
  4. Edit line 14 of the source code so it points to your dictionary
    ("my $dictionary = …"). Usually /usr/dict/words or /usr/share/dict/words.
  5. Once easypass.pl is configured, put it in a central location (e.g. /usr/local/bin) and let your users know.


When run without any options, EasyPass will return ten passwords, consisting solely of two random words from the dictionary, concatenated together. If hte dictionary file is missing, the program will not run until you update the script with the location of your dictionary file. (See above.) We suggest running EasyPass with a few options. They are listed below, or you can run easypass.pl -h.

The options supported by easypass.pl are:

-h, --help -- This option prints the options list, and a brief summary of the program.

-1, --oneword -- This option will force the program to use only one random word, as opposed to two; the default is "off" (or, to print two words). This option should be used when passwords have a limited effective length (such as older UNIX systems) where only eight characters have any effect on security.

-n, --number -- Adds a random, two-digit number to the password (the number of digits can be changed). By default, this option is off.

-s, --special -- Prints one special character (~, !, @, #, $, %, ^, &, *, (, ), _, -, +, or =) in the password (the number of special characters can be changed). By default, this option is off.

-l, --l33t -- Forces "l33t-sp34k" style passwords, (i.e., replaces "e" with "3", "o" with "0" (zero), "i" with "1", "a" with "4", "t" with "7", and "s" with "$").

-w=x, --word=x -- Forces the words chosen at random to be of a certain character length. The default setting is five, and can range from three to eight.

-d=x, --digit=x -- Forces the number of digits to be a certain length. For this option to have any use, the number option must be added (obviously). The number of digits can range from one to eight, and the default is two.

-g=x, --slength=x -- Forces the number of special characters to be a certain length. The default is one, and there can be up to eight.

-p=x, --passwords=x -- Forces a certain number of passwords to be printed. The default is ten.