Update to Innoslate Enterprise 4.12
Important Notes to Update to Innoslate Enterprise v4.12
To update your Innoslate Enterprise installation to version 4.12, note that there is no automatic updater due to the new Java 21 and Apache Tomcat 11 requirements included in the installer. Users will want to manually copy and paste their existing settings.properties
file after installation to preserve configurations. The user performing the update must have Administrator privileges on the machine where Innoslate is installed. Follow the steps below to prepare for this exciting update, due out September 2025.
Important Notes
- Prerequisite: Before starting the installation, make and save a copy of your
settings.properties
file (typically located at C:\Innoslate4\apache-tomcat\webapps\innoslate4\WEB-INF). This is required to preserve your configurations, as the installer does not automatically retain this file from the prior configuration. - If your instance is configured for AI from 4.10, review the AI Configuration Notes below to update your
settings.properties
file after installation.
Update Instructions
- Back Up
settings.properties
:- Locate your
settings.properties
file (typically in C:\Innoslate4\apache-tomcat\webapps\innoslate4\WEB-INF). - Save a copy to a safe location (e.g., a backup folder) before proceeding.
- Locate your
- Download the Installer: Obtain the Innoslate 4.12 installer. (To be released September 2025)
AI Configuration Notes
For instances with AI capabilities, update the settings.properties
file in C:\Innoslate4\apache-tomcat\webapps\innoslate4\WEB-INF after copying it to the new installation. If upgrading from v4.9 or v4.10 with existing AI settings, incorporate the following for v4.12 compatibility:
Pre-4.12 AI Settings (Retain if Applicable)
OPEN_AI_API_KEY=sk-password
OPEN_AI_ORGANIZATION=<ORG KEY>
Updated v4.12 AI Settings
Add or update the following in settings.properties
:
# Default Chat AI Settings
DEFAULT_CHAT_AI_API_KEY=sk-code
DEFAULT_CHAT_AI_SECONDARY=org-code
DEFAULT_CHAT_AI_MODEL=gpt-4o-mini
DEFAULT_CHAT_AI_PROVIDER=OPENAI
DEFAULT_CHAT_AI_URL=https://api.openai.com/v1/
# For Azure AI only
DEFAULT_CHAT_AI_URL_EMBEDDING=https://something.openai.azure.com/openai/deployments/text-embedding-3-small/embeddings?api-version=2023-05-15
# Default Image AI Settings
DEFAULT_IMAGE_AI_API_KEY=sk-code
DEFAULT_IMAGE_AI_SECONDARY=org-code
DEFAULT_IMAGE_AI_MODEL=dall-e-3
DEFAULT_IMAGE_AI_PROVIDER=OPENAI
DEFAULT_IMAGE_AI_URL=https://api.openai.com/v1/
Explanation of AI Settings
- DEFAULT_CHAT_AI_API_KEY: The AI key for the default chat service.
- DEFAULT_CHAT_AI_SECONDARY: Organization reference for OpenAI accounts (if required).
- DEFAULT_CHAT_AI_MODEL: Set to
gpt-4o-mini
for the default chat model. - DEFAULT_CHAT_AI_PROVIDER: Set to
OPENAI
for the default provider. - DEFAULT_CHAT_AI_URL: Set to
https://api.openai.com/v1/
for OpenAI. - DEFAULT_CHAT_AI_URL_EMBEDDING: Required only for Azure AI; update with your Azure endpoint.
- DEFAULT_IMAGE_AI_*: Similar settings for image AI, using
dall-e-3
as the default model.
Next Steps
- Ensure all configurations are correctly applied and test Innoslate functionality.
(Previous Article: Update to Innoslate Enterprise v4.11)