> For the complete documentation index, see [llms.txt](https://docs.flopsar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flopsar.com/3.0/administrator-guide/quick-installation.md).

# Installation

Before you install the software, make sure you meet the following requirements:

* You have at least a few GB of storage for `Server` data.
* Your networking environment does not block TCP connections between components.

## Server

There are two packages available for installation: `flopsar-server-X.Y.Z.deb` and `flopsar-server-X.Y.Z.rpm`. For Debian based distributions you can install it by executing the following command:

```
# dpkg -i flopsar-server-X.Y.Z.deb
```

For Red Hat based distributions you can install it by executing one of the following commands:

```
# rpm -ih flopsar-server-X.Y.Z.rpm
# zypper install flopsar-server-X.Y.Z.rpm
# yum install flopsar-server-X.Y.Z.rpm
```

{% hint style="warning" %}
You will not be able to run Flopsar unless you accept the [Flopsar End User License Agreement](http://flopsar.com/EULA.txt) (EULA). In order to accept the license, you have to set the environment variable `FLOPSAR_EULA_ACCEPT` to `YES`.
{% endhint %}

You can verify if the Flopsar has been installed successfully by executing the command:

```
$ flopsar
```

You should see the Flopsar banner similar to the one below:

```
  *******************************************************
  *   ______ _      ____  _____   _____         _____   *
  *  |  ____| |    / __ \|  __ \ / ____|  /\   |  __ \  *
  *  | |__  | |   | |  | | |__) | (___   /  \  | |__) | *
  *  |  __| | |   | |  | |  ___/ \___ \ / /\ \ |  _  /  *
  *  | |    | |___| |__| | |     ____) / ____ \| | \ \  *
  *  |_|    |______\____/|_|    |_____/_/    \_\_|  \_\ *
  *                                                     *
  *******************************************************

	Version:     3.0.0
	Build:       3.0.0 
	Released on: (release date)

    Copyright (C) 2012-present by Flopsar Technology
    http://flopsar.com
  *******************************************************
```

{% hint style="info" %}
For either `standalone` or `manager` modes you must have a valid license file inside your environment directory. For `database` mode, the license file is not required.
{% endhint %}

### Installation Example

In this example, we use the standalone architecture.

1. Create a new environment:

   ```
   $ flopsar init /opt/flopsar-server
   ```
2. Copy the license file:

   ```
   $ cp license.key /opt/flopsar-server/
   ```
3. Accept the EULA:

   ```
   $ export FLOPSAR_EULA_ACCEPT=YES
   ```
4. Start the server:

   ```
   $ flopsar start /opt/flopsar-server
   ```

## Agent

In order to install `Agent`, follow carefully the instructions below:

1. copy the agent file `flopsar-agent-X.Y.Z.jar`to your server machine.
2. create a directory (we call this directory as Flopsar home directory) and `ext` subdirectory for the agent data.
3. [configure](/3.0/administrator-guide/agent.md#configuration) the agent.
4. optionally put all your agent [plugins](/3.0/developer-guide/untitled.md) into the `ext` directory.
5. restart your application.

When the agent starts for the first time it does not have any configuration deployed. It just registers itself to the manager, after a successful connection, and does not instrument anything.

### Installation Example

In this example we assume there is already a `Server` instance running and listening on `A.B.C.D:port` socket address.

1. Create a Flopsar home directory along with the `ext` directory:

   ```
   $ mkdir /opt/flopsar
   $ mkdir /opt/flopsar/ext
   ```
2. Copy the agent file:

   ```
   $ cp flopsar-agent-X.Y.Z.jar /opt/flopsar/
   ```
3. Copy some plugins:

   ```
   $ cp my-plugin.jar /opt/flopsar/ext/
   ```
4. Update JVM start options:

   ```
   -Dflopsar.id=MyApp                  \
   -Dflopsar.home=/opt/flopsar         \
   -Dflopsar.manager=A.B.C.D:port      \
   -javaagent:/opt/flopsar/flopsar-agent-X.Y.Z.jar
   ```
5. Restart your application. If the installation was successful, a log file `/opt/flopsar/MyApp.0.log` should appear.