Getint: Where every ticket finds it's place.
Support portalCase studiesSchedule a demo
  • Welcome to the Getint Documentation Hub
  • Getting started with Getint
    • About Getint / Concepts
      • How Getint works (how it syncs the data)
      • Onboarding
      • What is a Connection?
      • What Are Runs
      • One-directional / Bi-directional integration
      • Migration vs Integration
      • How Integrations Are Executed By Getint
    • Starting the Free Trial and Accessing the Getint App
      • Selecting the Correct app per license
      • How do I extend the trial of getint.io?
      • Jira Access and User Management
    • Deployment options
      • Getint for Jira Data Center / Jira Server
        • Getint Jira Server / Jira Data Center App (native)
        • Getint for Jira Data Center / Jira Server - Architecture
      • Getint for Jira Cloud
      • Getint On-Premise
        • Architecture
        • Installation
          • How to Install Getint On-Premise in Windows Server
          • On-Premise/Standalone Guide
        • Updating On-Premise
        • Cluster High Availability
    • Prepare for the integration
      • Understanding the difference between platforms you integrate
      • One-to-One, One-to-Many, and Many-to-Many integration
      • Simplifying Workflow Sync with Getint: Jira
    • Connectors
      • Jira
      • Asana
      • Azure DevOps
      • Freshdesk
      • GitLab
      • HubSpot
      • Monday.com
      • Notion
      • Salesforce
      • ServiceNow
      • Zendesk
  • Guides
    • Quickstart
      • Integration
      • Connection
    • Integration Guides
      • How to Map Fields
      • How to create a custom field in all supported software
      • Git Repository integration
        • Git Connector - Azure DevOps
        • Git Connector - GitHub
        • Git Connector - GitLab
      • Azure DevOps Asana integration
      • Jira Airtable integration
      • Jira Asana integration
        • Jira - Asana: Subtasks synchronization
      • Jira Azure DevOps integration
        • How to Setup a Connection with Azure DevOps On-Premise
        • Jira - Azure DevOps: Epics and Subtasks Synchronization
        • Syncing Dependencies between Jira and Azure DevOps using Getint
      • Jira ClickUp integration
      • Jira Freshdesk integration
      • Jira Freshservice integration
      • Jira GitHub integration
      • Jira GitLab integration
        • Attachments Sync in GitLab Integration
      • Jira HubSpot integration
      • Jira Jira integration
        • Jira Jira licensing
        • Time Tracking in Getint – One-Way Synchronization
      • Jira Monday.com integration
        • Synchronizing Attachments in a Monday.com Integration
        • How to Insert Monday.com Items into Specific Groups Using Getint
      • Jira Notion integration
      • Jira Salesforce integration
        • Salesforce OAuth Authentication
      • Jira ServiceNow integration
        • Creating a ServiceNow User for Getint Integration
        • ServiceNow OAuth authentication
        • Creating a Custom Field in ServiceNow
        • How to Restrict "Incident" Data to Specific 3rd Party Companies
        • How to Restrict Access to Specific Tables for Integration
        • REST API requests list
      • Jira Trello integration
      • Jira Wrike integration
      • Jira Zendesk integration
        • How to Manually Provide Zendesk Organization ID and Name
    • Migration Guides
      • Migrating Data with Getint
      • Migration support, and onboarding
      • Jira to Jira migration
      • Asana to Jira migration
      • Azure DevOps to Jira migration
      • GitLab to Jira migration
      • Jira to Monday.com Migration
      • Jira Zendesk migration
  • Using Getint
    • Core Features of Getint
    • Workflows
      • Type Mapping
      • Integrations List
      • Configuring Your Data Sync: Bidirectional and Unidirectional Options
      • Syncing Attachments
      • Hierarchy
      • Assignees (users) mapping
      • Mapping Labels
      • Filtering Items for Integration in Getint
        • Troubleshooting Sync Issues: Unmet Filter Conditions
        • How to Filter Comments
        • Filtering by Assignment Group and Status
      • Shared Mappings in Getint – Centralized Mapping for Efficient Integrations
      • How to Use JQL Filters for Jira Integrations
      • Integration status
      • Storing counterpart link in the task comment
      • Storing Reference IDs/URLs Across Integrations
    • Connections
      • Troubleshooting Getint Integration Connectivity Issues
      • Permissions Issue: Status Code 500
      • Editing Connections for Existing Integrations
      • Changing the URL or Transitioning Between Instances
      • Debugging Connections in Getint: How to Troubleshoot and Resolve Issues
    • Quick Build
    • Reporting
    • Notifications
    • Request type issue on Jira Service Management how to select and work with it
    • Integrating one project with many: Streamlining synchronization across multiple projects.
      • One to Many Project - El Ride Use Case
    • Transition Fields
    • Resync and Hard Resync
    • Synchronizing Existing Items on Both Sides
    • Handling Syncs for Deleted Items
    • Advanced Scripting
    • Platform Release History
      • Getint Version 1.79
      • Getint Version 1.78
      • Getint Version 1.77
      • Getint Version 1.76
      • Getint Version 1.75
    • Settings
      • Data Storage
      • Sharing Access Permission
      • How to Override Getint Behavior Using Custom Properties
  • Support, legal & others
    • FAQ
      • Technical FAQ
      • Security FAQ
    • Troubleshooting Guide for Getint Users
      • Resolving Error 500 in Jira ServiceNow Integration
      • Locating Your Instance ID for Support
      • Connection Error: Certification Path Failed/PKIX Path Building Failed
      • Error: Field '<field-name>' cannot be set. It is not on the appropriate screen, or unknown
      • Connection timed out error
      • Troubleshooting: Integration Task Retrieval Error
      • Upgrade to newest version from version lower than 1.52
      • Debug Requests Feature
      • Troubleshooting: Resolving Hanging Integration Runs in Getint
      • Troubleshooting License Issues in Getint
    • Security and compliance
    • Support / SLA
    • Privacy & Security
      • Data Residency with Getint
    • Procurement & Legal
      • Enhanced Support for Vendor Onboarding and Security Assessments
      • EULA
      • Privacy policy
  • Billing & Services
    • Transparent and User-Friendly Pricing
    • Consulting and Custom Development
    • Understanding Getint Licensing and Pricing
      • How to pay for the apps
      • Migrations
      • Network License
      • Jira-Jira Licensing Model
      • Partners
      • Seamless Transition Offer: Migrate from Competitors to Getint with Exclusive Benefits
  • Use cases
  • Pricing Comparison: Getint vs. Alternatives
  • Battlecards (getint.io vs competitors)
  • Free migration from ConnectAll, Backbone, Exalate, Unito, Workato, TFS4JIRA and other tools
  • Anything missing? Getint is feedback driven
Powered by GitBook
On this page
  • How to Install On-Premise
  • Docker - Docker-compose installation

Was this helpful?

  1. Getting started with Getint
  2. Deployment options
  3. Getint On-Premise

Installation

PreviousArchitectureNextHow to Install Getint On-Premise in Windows Server

Last updated 2 months ago

Was this helpful?

For those looking for enhanced performance, superior workflow management, efficient operations, and robust data security, On-Premise emerges as an exceptional solution. You’re in control of your data during any changes or updates, and it all happens within your custom server. This ensures that there are no other requests, except for the applications you are integrating. Thus, On-Premise offers a compelling blend of power and privacy.

How to Install On-Premise

This detailed guide will cover all the necessary steps to install in your dedicated network.

Installation requirements

  • Ubuntu / Debian / Redhat / Windows server / Docker - Server requirements

  • Root user access

  • Your Getint binary and License files. If you do not have them, please get in touch with us at

Server requirements

Minimum

Recommended

2GB Ram

4GB Ram

1 vCPU

2 vCPU

60 GB HDD

60 GB SSD

Installation steps

  1. Open your terminal and sign in to the machine as a root user.

    • Use the SSH command and replace youripaddress with the hostname or IP address of the server:

ssh root@youripaddress

  1. Enter your password:

    • You’ll be prompted to enter your password for the specified username

  2. Download Getint files:

    • Getint will provide these. Use the command wget + the link to the files to download the installation package

    • Use the command ls -al to see the files in the current directory, and ensure the zip files are located there

  3. Extract the files

    • Use the unzip command to extract Getint files in the directory. For instance, it should be like this: unzip getint-1.58.zip

    • Run apt install unzip to download an unzip tool if you don’t have one

  4. Switch to the Getint directory

    • After the installation, switch the directory to the new Getint folder by running cd getint

    • Now enter cd synchronizer to open the Getint installation folder

  5. Make sure you have the necessary tools to run Getint

    • Install Java if it isn’t available on your machine. Enter the command apt install default-jre and press Y then Enter when prompted. Press ctrl + c to return to the directory.

    • Make sure Java is now installed with the command java --version

Please note that we support Java versions 8 through 17.

  1. Running Getint

  • Use the command ./manager.sh start to launch Getint. Press ctrl + c to close the logs and return to the directory

  • Check if Getint is up and running in the background by using the command ps -aux | grep getint

  1. Accessing Getint

  • These are the credentials you can use to log into Getint via your browser:

    • Username: admin

    • Password: admin

  • Open the browser and type the URL which is the machine’s IP address. Alternatively, if you have any domain name assigned to the machine on which Getint is installed, you can type that domain name

  • Other commands you can use to manage your instance:

    • ./manager.sh stop stops the integration, so you won’t be able to access it until you start it again

    • ./manager.sh restart restarts the integration in case you have made some changes to the directory

Getint will start on port 80 by default. If port 80 is already in use, change it with the command vim getint.env

After switching ports, use the command cat getint.env to see the current port in use.

Video tutorial

Here’s a video tutorial that demonstrates how to install the On-Premise version.

Docker - Docker-compose installation

The initial steps are similar to installing Getint on your dedicated machine, but they have remarkable differences in how the app is installed and fully executed. Ultimately, it will depend on your server requirements.

As Docker is a separate tool, please ensure it is installed on your machine before running Getint. Otherwise, Getint won’t start, and your terminal will pop up an error.

  1. Open your terminal and sign in to the machine as a root user.

    • Use the SSH command and replace youripaddress with the hostname or IP address of the server:

ssh root@youripaddress

  1. Enter your password:

    • You’ll be prompted to enter your password for the specified username

  2. Download Getint files:

    • Getint will provide these. Use the command wget + the link to the files to download the installation package

    • Use the command ls -al to see the files in the current directory, and ensure the zip files are located there

  3. Extract the files

    • Run apt install unzip to download an unzip tool if you don’t have one

    • Use the unzip command to extract Getint files in the directory. For instance, it should be like this: unzip getint-1.58.zip

  4. Switch to the Getint directory

    • After the installation, switch the directory to the new Getint folder by running cd getint

    • Now enter cd synchronizer to open the Getint installation folder

    • Use the command cd docker, and then cd scripts

  5. Installing docker if it isn't installed on your machine

  1. Installing docker-compose on your machine

    • It is also necessary to have docker-compose as our installation will consist of the PostgreSQL database, Nginx, and the Getint app. After the installation, use the command docker-compose version to ensure the tool is installed

  2. Running Getint

    • While in the scripts folder, enter the command sh start.sh to launch Getint

    • Ensure Getint is running in the background by using the command docker container ls

  3. Accessing Getint

    • These are the credentials you can use to log into Getint via your browser:

      • Username: admin

      • Password: admin

    • Open the browser and type the URL which is the machine’s IP address. Alternatively, if you have any domain name assigned to the machine on which Getint is installed, you can type that domain name

    • Other commands you can use to manage your instance:

      • sh stop.sh

      • sh restart.sh

Getint will start on port 80 by default. If port 80 is already in use, change it with the command vim ../docker-compose.yaml

After switching ports, use the command docker container ls to see the current port in use.

Video tutorial

Here’s a video tutorial on how to Install Getint in a docker.

The installation path will depend on the tool you’re using. For example, we’re using Ubuntu 20, and the installation package is available here: . However, if you’re using a different distribution, click on Docker Engine, then click on Install, and locate your distribution under this page. After the installation, use the command docker version to ensure the tool is installed

Docker-compose standalone is available here:

Our amazing team at Getint is always here to support you throughout your integration journey. We specialize in providing the best possible customer experience. If you have any questions about the setup process, please open a ticket with us at our or .

getint.io
support@getint.io
Install Docker Engine on Ubuntu
Install Compose standalone
Help Center
Schedule a Demo
Having issues building your integration? Schedule a free consultation with our Integration Experts now!
Elevate your integration journey! Schedule a free consultation with our Getint Integration Expert today