Installation Guide
Welcome to Xill4!
This guide will help you to set up the Xill4 application as a background service.
Prerequisites
- System requirements.
- A valid license key. To obtain a valid key please contact Xillio.
As a prerequisite, you need to have a MongoDB instance (5.x or higher) running. If you don't have one, you can install it using the MongoDB installer from the MongoDB website.
By default, Xill4 will try to connect to mongodb://localhost:27017/xill4_system
. If you want to change this, you can do so by setting the XILL4_DATABASE_CONNECTION_STRING
system environment variable.
Installation
-
Verify or add the following environment variables:
Required Variables
-
XILL4_LICENSE_KEY
-
XILL4_ENVIRONMENT_SECRET
. A string that is used to encrypt and decrypt secrets. This is used to store sensitive data. Try to come up with a unique string to be safe. Add the following environment variableXILL4_ENVIRONMENT_SECRET=
to the .env file and add your secret after the=
sign.noteIf
openssl
is installed, in terminal you can use the commandopenssl rand -hex 24
to generate a random string that you can use as a secret.In case you want to avoid adding
XILL4_LICENSE_KEY
andXILL4_DATABASE_CONNECTION_STRING
as environment variables, you can simply edit theconfig.yml
. TheconnectionString
refers to theXILL4_DATABASE_CONNECTION_STRING
variable explained in prerequisites.license:
key: //REPLACE-ME-PLEASE;
database:
connectionString: //root:example@localhost:27017/xill4_system?authSource=admin
mongodb:
logger:
levels:
- error
- info
- warn
- debug
# - trace
# - http
-
Optional Variables
XILL4_WORKDIRS
(optional, default:n/a
). Set if file system access is required. For more information on how to set up file system access, see the documentationXILL4_MONGO_CONNECTION
. Example:mongodb://localhost:27017/ContentStore
. The string to the MongoDB instance. This can be used in the component's configuration to establish a Mongo connection.
A comprehensive list of environment variables to customize Xill4 behavior is available in the official documentation. :::
How to start the application
Although not required, we recommend setting the following environment variables XILL4_PROJECT_PATH
to change
the default locations of the project directory. This eases the upgrade process.
- Run the
install.bat
file to install Xill4 as a service from the command line with administrator privileges. - You can run the executable file from the terminal by navigating to the folder where the .exe is located and type .\Xill4.exe.
Once the application has started, navigate to http://localhost:8000/.
Upgrade
- Back up your project folder.
- Run the uninstall.bat file to uninstall Xill4 as a service from the command line with administrator privileges.
- Run the
upgrade.exe
tool to upgrade your existing projects. - Run the install.bat file to install Xill4 as a service from the command line with administrator privileges.
There is currently a hard limit of 34 projects while upgrading. If you need to upgrade more projects, separate them in multiple folders.
Uninstalling
- Run the
uninstall.bat
file to uninstall Xill4 as a service from the command line with administrator privileges.
Usage
By default, the application will be accessible using the browser and is running using the Local System account
.
The account can be changed using the Windows Services Manager
. Further configuration can be done using environment variables described in the built-in documentation, which is accessible from the front page of the application and on the Xillio website.