Skip to main content

The steps needed to install the open source version of the WiKID Two-Factor Authentication System Community Edition, Version 3.x RPMs.


Hardware Requirements

  • 8+ gigs of hard drive space.
  • A Redhat flavor of Linux such as RHEL or Centos
  • 1 gig of RAM (2 gigs if using replicatoin)
  • 1 Ethernet connections (2 is preferred)
  • Moderate CPU required
  • These hardware specs are for production. The server has been tested in a 256 meg RAM vmware image.

Doing the work

    1. Install required software
yum install postgresql postgresql-libs postgresql-jdbc postgresql-server postgresql-pl compat-libstdc++-296 ntp system-config-date perl-libwww-perl mlocate
    1. Install the JDK:

      yum install java-1.6.0-openjdk
    2. Test that the system is using the correct Java:
java -version
    1. If you haven't already, be sure to initialize the database:
      # service postgresql initdb
    2. Download the WiKID rpms from Sourceforge and install them. You will need both the wikid-server-community-3.xx.rpm and the wikid-utility rpm.
yum install --nogpg wikid-*
    1. Setup the WiKID server. The WiKID token clients communicate with the WiKID via port 80 (https is not needed because the PINs and OTPs are asymmetrically encrypted, so you will need a routable IP address. If you are just testing, then just make sure that the PC running the client can get to the server.
/opt/WiKID/bin/wikidctl setup
      The script will pick up your existing network settings, walk you through them and create an SSL cert for the server.
    1. Once setup, start the server
/opt/WiKID/bin/wikidctl start
  1. Go to https:///WiKIDAdmin/ to complete the set up. From here, you can follow the standard documentation. If you like short docs, we recommend the Quickstart Cheatsheet:

More Information

You may need to install the JCE Unlimited Strength Jurisdiction Policy Files to avoid the "Illegal Key Size error".

The WiKID software token clients require port 80. You can use NAT, but it needs to be routable for the token clients. The following services may only need internal access based on your needs:

  • The WiKIDAdmin uses 443.
  • wAuth uses 8388
  • LDAP uses 10389
  • TACACS+ uses 49


We test this stuff on our own machines, really we do. But you may run into problems, if you do, come to #fedora on


Copyright © WiKID Systems, Inc. 2024 | Two-factor Authentication