Проверите да ли је читач исправно инсталиран на систему тако што у терминалу покренете наредбу pcsctest. Наредба ће исписати информације о читачу укључујући и његов назив, а испис треба да „реагује“ када се картица убаци или извади из читача. Већина УСБ читача би требало да раде одмах по укључивању, али за неке може бити потребан PC/SC драјвер (ifhandler) са сајта произвођача.

Ако се приказао прозор са грешком као на слици, сигурно је да имате инсталирано јава радно окружење. Програм би требало да захтева инсталацију Oracle Java радног окружења ако оно није већ инсталирано, тако да вероватно управо и имате инсталирано Oracle Java окружење. Ако се програм уопште не покреће, погледајте решење за проблем #3.

Програм ће се приказивати на српском уколико је српски подешен као подразумевани језик на систему. Отворите подешавања система и потражите листу у групи Language & Region или на старијим системима у групи Language & Text на првој картици Languages. Прво додајте српски у листу, а затим га превуците изнад енглеског. Може бити неопходно да рестартујете рачунар након што потврдите подешавања.

Програм захтева инсталацију Oracle Java окружења. Због величине датотеке (преко 100MB) Јава окружење није укључено у пакет апликације. Требало би да уколико на систему није већ инсталирана Јава (због покретања Јава аплета на пример) програм затражи инсталацију при првом покретању. У сваком случају покушајте да са сајта java.com преузмете и инсталирате Oracle Java окружење.

Да проверите верзију и издање Јаве, можете да потражите одељак Java у системским подешавањима или да ред по ред прекопирате следеће наредбе у терминал:

/Library/Internet\ Plug-Ins/JavaAppletPlugin.plugin/Contents/Home/bin/java -version
/usr/libexec/java_home -v
java -version

Иако старији Mac OS X 10.7 долази са Apple Java 1.6 окружењем, програм је преведен за Java 7 окружење па је за коришћење програма ипак неопходно да инсталирате новије Oracle Java окружење.

Уколико желите да користите програм са Apple Java 1.6 или на систему Mac OS X 10.6 (Snow Leopard), доступни су посебни савети на викију.

Apple Gatekeeper може да онемогући покретање програма који нису аутентификовани кроз Developer ID програм. Уколико кликнете десним тастером и из менија одаберете покретање апликације требало би да се прикаже прозор у коме можете да потврдите изузетак и наставите коришћење програма.

Gatekeeper подешавања се налазе у групи „Security & Privacy“. Apple Gatekeeper је користан и немојте га олако искључивати. Али уколико имате проблем са покретањем ове апликације, покушајте да привремено искључите, покушате да тада покренете програм и затим вратите подешавања на претходну вредност.

Уколико поседујете Apple Developer ID сертификат, и желите да помогнете и њиме потпишете издања програма JFreesteel eID Viewer, погледајте инструкције у Гит складишту и јавите се е-поштом.