Skip to content
  • There are no suggestions because the search field is empty.

Docker Installation Guide for Mac/Linux

Learn how to install Innoslate Enterprise on Mac and Linux using Docker

Sections Available in Enterprise Installation

Function Description
Installation Requirements Discover the specific hardware, software, and system prerequisites needed for a successful Enterprise installation
Pre-Installation Prepare your backend infrastructure, including tasks for system configuration and database setup.
Installation Instructions Follow the detailed installation steps provided in the guide to install Enterprise on Innoslate.
Innoslate Setup To successfully set up Innoslate, follow the detailed steps provided in this section.
Troubleshooting
  Need to make configuration changes to your setup? Check out our  troubleshooting tips.

Installation Requirements

macOS

Minimum Requirements — macOS

  • macOS 12 Monterey or later
    • Apple Silicon (M1/M2/M3) requires Docker’s --platform=linux/amd64 emulation
    • Intel Macs can supported natively
  • Dual-core 64-bit CPU (Intel i5 or Apple M1)
  • 4 GB RAM
  • 10 GB free disk space (SSD recommended; ~500 MB used by Innoslate application files, remainder for database and logs)
  • PostgresSQL 14 or newer
  • Docker Desktop for Mac (optional)

Recommended Requirements — macOS

  • macOS 14 Sonoma or later
    • Apple Silicon (M1/M2/M3) requires Docker’s --platform=linux/amd64 emulation
  • Quad-core 64-bit CPU (Apple M1 Pro/M2 Pro or higher)
  • 8 GB RAM
  • 25 GB free disk space (SSD strongly recommended; ~500 MB used by Innoslate application files, remainder for database and logs)
  • PostgresSQL 15 or newer
  • Docker Desktop for Mac (optional)

Linux

Minimum Requirements — Linux

  • Ubuntu 20.04 LTS / Debian 11 (or equivalent)

  • Dual-core 64-bit CPU

  • 4 GB RAM

  • 10 GB free disk space (SSD recommended; ~500 MB used by Innoslate application files, remainder for database and logs)

  • Docker Engine

Recommended Requirements — Linux

  • Ubuntu 22.04 LTS+

  • Quad-core CPU

  • 8 GB RAM

  • 25 GB free disk space (SSD strongly recommended; ~500 MB used by Innoslate application files, remainder for database and logs)

  • Latest Docker Engine

Pre-Installation

  • Install Docker Desktop (optional) to help manage containers through UI/UX for better usability

  • Download the latest version of the Innoslate Docker Compose and unzip into a targeted directory

  • Confirm ports are available (8080, 80, or other preferred ports)

  • Enable colima or native virtualization for Mac ARM (if needed)

Installation Instructions

Please follow the steps to be mentioned in succession to successfully install Innoslate on your device using Docker.

  1. Open the "terminal" and cd into the unzipped folder.

    cd ~/[File Location]/"Innoslate Docker Compose"
    Make sure to replace "[File Location]" with the path in which the Docker Compose file can be found. You can also drag and drop the folder from Finder into the Terminal to auto-fill the path.
  2. Make the installation script executable 
    chmod +x install.sh
  3. Run the installation script
    ./install.sh

    The script will prompt you for:
     • Host port — Input your desired port designation
     • Use NGINX? (y/n) — Input your choice to use NGINX. For mac, input "n".
     • Use Postgres? (y/n) — Input if user would like to use Postgres. If "y":
          • Postgres database name — Input your desired name designation
          • Postgres password — Input a secure database password

  4. Wait for containers to start
    The script will pull necessary Docker images and run them. This can take several minutes the first time. To verify: 
    docker compose ps

    You should see a report on that notes the images currently running active in your docker:
     • innoslate (Up)
     • postgres (Up)

Optional Note: If you are using the Docker Desktop application on your device, you can visually confirm that the Innoslate and PostgreSQL containers are running after completing step 3. Docker Desktop will display each container’s name, image, port mapping, and status.

Docker_Example

In the example above, Docker Desktop shows the innoslatedockercompo stack, with the innoslate container (running image innoslate/innoslate:4.1) and the postgres container (running image postgres:15.7) both active in the environment.

Innoslate Setup

Once the containers are running, open your browser and go to: http://localhost:[PORT]/setup

For step by step walkthrough of the Setup Panel, use this link. For this setup purpose, we will only go over the Database section of this docker setup.

Setup_database

Follow the precise steps below for this setup phase:

  • Database Type: PostgreSQL

  • Database Host: postgres

  • Database Port: leave empty or 5432

  • Database Name: [Name entered during install]

  • Database Username: postgres

  • Database Password: [Password set during install]

Click "Validate" to ensure the database phase is set up appropriately.

Note: The steps in the Innoslate Setup Panel follow the same familiar sequence as in previous Innoslate installations (EULA, license, database, etc.). Users can expect the process to work just like in other environments.

Filesystem 

By default, Innoslate stores uploaded files in a Windows-style directory (C:\InnoslateFileStore), which isn’t suitable for Mac or Linux environments. To ensure proper file storage and platform compatibility with the docker, it’s recommended to change the File Storage Path to a directory within the container.

You can apply this change in one of two ways: During the Initial setup and After installation

Option 1 – Set During Initial Setup (Preferred)

The Filesystem field is included in the Innoslate Setup Panel. This is the easiest and cleanest way to configure storage.

In the Filesystem section:

  • Type: Native

  • File Storage Path: /usr/local/innoslate/filestore

Innoslate will automatically update WEB-INF/settings.properties with the correct path.

Setup_Filestorage

Continue the setup process normally.

Option 2 – Update After Installation (Post-Install Fix)

If you have already completed setup, you can still change the storage path by editing the settings.properties file directly inside the running container using Docker Desktop.

Please follow the steps to be mentioned in succession to successfully install Innoslate Enterprise on your device using Docker.

  1. Open the container in Docker Desktop

    • Launch Docker Desktop → Containers.
    • Expand your stack and click the innoslate container.
  2. Navigate to the settings file and open the Files tab.
    Browse to:
    /usr/local/tomcat/webapps/ROOT/WEB-INF/settings.properties
  3. Select settings.properties file to open the editor and find "STORAGE_FILESTOREPATH". Replace the existing value with:
    /usr/local/innoslate/filestore

  4. Save the settings.properties file and restart your Innoslate container. Files will now be stored appropriately in the docker container.

Settings.properties_change

Troubleshooting

If you run into issues, you can investigate and resolve them either via the Docker Desktop or directly in the terminal:

Using Docker Desktop (GUI):

Below are examples of tasks you can perform in Docker Desktop:

  • Start and stop containers.

  • Check container status (e.g., “Up” or stopped).

  • View and configure Innoslate files.

  • View container logs by selecting a container → Logs.

  • Monitor CPU and memory usage under the Dashboard/Stats tab — useful for diagnosing performance issues.

Using the Terminal (CLI):

Below are examples of commands for common functions. These are not exhaustive — many more Docker commands are available.

  • See running containers – Lists all active containers and their status:

docker compose ps

  • View real-time logs – Shows live output from containers, useful for troubleshooting errors:

docker compose logs -f

  • Restart services – Stops and starts a container without deleting it (keeps your data):

docker compose restart innoslate
docker compose restart postgres

  • Stop all services – Safely stops all containers in the project:

docker compose down

  • Start services (fresh) – Starts containers again (pulls images if needed):

docker compose up -d

To conclude, installing Innoslate Enterprise with Docker has never been easier. We aim to make this a straightforward, repeatable setup process. Once the containers are running, the Setup Panel experience remains the same as in other environments, so existing users will find it familiar and intuitive. By following the steps in this guide, you can quickly deploy a fully functional Innoslate instance on your Mac/Linux/Windows for enterprise installation.