Self-managed Server Installation

This guide is intended for IT professional responsible for installing the ActivityInfo Self-managed Server in an on-premise server.

Introduction

While we seek to provide convenient installation packages for common platforms such as Debian Linux and Windows Server, ActivityInfo is a platform-independent Java application that can run wherever a Java 8 Runtime Environment (JRE) is available.

Getting started

Make sure you have Java 8 installed and available on your path. Running the command java -version should print something similar to the following:

openjdk version "1.8.0_292"
OpenJDK Runtime Environment (build 1.8.0_292-8u292-b10-0ubuntu1~20.04-b10)
OpenJDK 64-Bit Server VM (build 25.292-b10, mixed mode)

Then, download the latest latest JAR release.

You can start the server directly by running:

java -jar activityinfo_4_0_14.jar

The server, by default, will start immediately and listen on port 8081 for HTTP requests. It will also initialize an Sqlite database in the working directory.

Configuring the server

On startup, the ActivityInfo Self-managed server will look for a file named config.ini in the working directory.

You can specify alternate an HTTP(S) port and data directory in config.ini:

[Server]
Http Port=80
Https Port=443

[Data]
Data Directory=/var/lib/activityinfo

Read the complete configuration file reference.

ActivityInfo also provides a web-based configuration interface for other server options, such as Single-Sign On (SSO), mail delivery, and SSL. To use this interface, ensure that config.ini is writable by the java process.

Creating the administrator account

When starting the Self-managed Server with an empty database, you can create the administrator account by navigating to, for example, http://localhost:8081.

Additional configuration

Next, follow the instructions in the Configuration guide to configure Email delivery, an SSL certificate, and Single Sign-On.