Installation of the Java agent


Installing the Sqreen Java agent enables you to monitor the security of your application and block attacks in real-time. Installing Sqreen in your Java application takes less than a minute:

  • Sign up to Sqreen to create your account
  • Pick up your first application name and Java language. The name of the application can be the name of the repository, or anything that will help you identify the app in your Sqreen dashboard
  • Follow the procedure detailed below

Standard Java Application

The installation of the Java agent only requires to zsur the JVM settings.

Download the agent

$ curl -o sqreen-latest-all.jar

Edit the JVM startup file:

-javaagent:/path/to/agent.jar -Dsqreen.token=<your Sqreen token>

Then start the application as usual.

Install the agent on multiple environments

You will probably install the Sqreen Java agent on your production environment. You can also create several applications for each of your environment (development, staging, production). For each, a unique Sqreen token will be provided for each of your applications.

Basic configuration

Instead of using the system property value (-D flag), you can also use SQREEN_TOKEN environment variable to set up your token:

export SQREEN_TOKEN=my_secret_token

The Sqreen Java agent provides additional configuration settings. Refer to Configuration of the Java agent for more detailed information.

Uninstall the agent

To uninstall the Sqreen agent, simply remove the -javaagent flag from the JVM startup file.


Use Sqreen throughout the development cycle

Sqreen can protect your application from your local environment to your production through your staging. Simply create an application per environment in the dashboard and setup the token accordingly.