Serposcope requires Java 8. To check if Java is correctly set up on your operating system run java -version.
Since serposcope 2, it's the only dependency. The database and the HTTP server is now embedded in the software to make it easier to set up.
Also, we highly advise you to create an account on a captcha breaking service.
Important notice : serposcope may take up to ~30 seconds to start at first run.
Download windows version and run it as administrator. Follow instructions.
Serposcope should now be installed and started at the following URL http://127.0.0.1:7134/.
Serposcope will be automatically launched at each startup.
Use serposcopew.exe or serposcope-monitor in start menu to monitor/restart serposcope.
Most of the time your system is using Java 32 bits version, even if you are running a 64 bits Windows version. The Java64 version is dedicated to Windows system using a 64 bits version of Java. Always try the "32 bits & 64 bits version" first before trying the Java64 version.
To know if you are using a 64 bits or a 32 bits version of Java, run the java -version in cmd.exe.
A 64 bits JVM will display :
java version "1.8.0_73" Java(TM) SE Runtime Environment (build 1.8.0_73-b02) Java HotSpot(TM) 64-Bit Server VM (build 25.73-b02, mixed mode)
A 32 bits JVM will display :
java version "1.8.0_73" Java(TM) SE Runtime Environment (build 1.8.0_73-b02) Java HotSpot(TM) Client VM (build 25.73-b02, mixed mode)
First, check if java > 1.8 is setup. Open a terminal and execute java -version and be sure it is at least 1.8 version.
admin@localhost:~$ java -version
java version "1.8.0_66"The recommended way to install Java 1.8 on ubuntu is to use the web upd8 repository :
sudo apt-get -y install software-properties-common
sudo add-apt-repository -y ppa:webupd8team/java
sudo apt-get update
sudo apt-get -y install oracle-java8-installer
More Instructions can be found on the following website :
If you did set up Java via another way, be sure to have environment variable JAVA_HOME defined. This variable should contain the java installation folder.
So if you did install Java to /opt/java/1.8 then the java binary should be located here /opt/java/1.8/bin/java and JAVA_HOME=/opt/java/1.8
More information about JAVA_HOME here.
Now, download serposcope .deb package and execute :
sudo dpkg -i serposcope.deb
Serposcope should now be installed and started at the following URL http://127.0.0.1:7134/.
If serposcope can't locate JAVA_HOME, you can define it in /etc/default/serposcope
Serposcope will be automatically started at each boot, if you want to start, stop or restart serposcope do :
sudo service serposcope start|stop|restart
First, check if java > 1.8 is setup. Open a terminal and execute java -version and be sure it is at least 1.8 version.
admin@localhost:~$ java -version
java version "1.8.0_66"On MAC, it maybe necessary to download specically the Oracle JDK 1.8 you can find here on the official website.
Download the jar version of serposcope.
Open a command line and run java -jar serposcope.jar, it will start serposcope at the following URL http://127.0.0.1:7134/.
We don't provide an automatic installer or a way to autostart serposcope at each boot yet, but contributions are welcome.
These directories and files are automatically created at first serposcope run. Their paths differ regarding your operating system.
Windows
Most of the time, located in C:\ProgramData\serposcope or check the value of the environment variable %ProgramData%
This folder contains a logs folder with all the log files, the database db.mv.db and the configuration files serposcope.conf.
Debian/Ubuntu
/etc/serposcope.conf/var/log/serposcope//var/lib/serposcope/Mac OSX/Linux/Generics
The datadir is located in the serposcope user directory, for example if the user bob launched serposcope it will be /Users/bob/serposcope or /home/bob/serposcope.
Folders follow the same hierarchy as Windows.
You can tweak serposcope configuration using the serposcope.conf files.
If you directly launch serposcope with the Java command (Mac OSX and Generic package) you need to pass the path of serposcope.conf :
java -Dserposcope.conf=/path/to/serposcope.conf -jar serposcope.jar
On Windows and .deb package this path is already specified. Check serposcope.conf path in datadir.
WARNING: Most of the time you don't need to edit this file. Serposcope works out of the box without additional configuration.
# path where is stored embedded database and data files
#serposcope.datadir=
# log path
#serposcope.logdir=
# alternative database url, mysql example to use mysql :
# serposcope.db.url=jdbc:mysql://HOSTNAME/DATABASE?user=USER&password=PASS&allowMultiQueries=true
#serposcope.db.url=
# additional database options
#serposcope.db.options=
#serposcope.db.debug=
# listen interface
#serposcope.listenAddress=
# listen port
#serposcope.listenPort=