Skip to content

Linux Installation

This comprehensive guide covers installation of Tycho Data Osprey on Linux distributions (Ubuntu 20.04/22.04). The installation process has been broken down into specific workflow stages for easier navigation and implementation.

Installation Overview

Osprey for Linux uses Docker containers and can be deployed using Docker Compose. The complete installation process involves:

  1. Pre-flight checks and server preparation
  2. Choosing between online and offline installation methods
  3. Executing the selected installation process
  4. Creating the initial administrator account
  5. Upgrading Osprey to a newer version

Installation Workflow Pages

Navigate to the specific page that matches your current installation stage:

1. Pre-flight Checks and Requirements

Start here to verify your Linux server meets all requirements and prepare for installation:

  • Hardware and software requirements verification
  • Docker and Docker Compose installation
  • Network connectivity testing
  • Prerequisites installation and configuration

2. Online Installation Process

For servers with internet connectivity that can download packages directly:

  • Automated bootstrap script installation
  • Real-time package downloading
  • Simplified dependency management
  • Troubleshooting online installation issues

3. Offline Installation Process

For air-gapped environments without internet access:

  • Offline package preparation and transfer
  • Manual Docker image loading
  • Isolated environment configuration
  • Offline troubleshooting procedures

4. Create Administrator Account

Set up the initial administrator account and configure user management:

  • First account creation process
  • User role configuration
  • Authentication setup options
  • Account management best practices

5. Upgrading Osprey

Upgrade your Osprey deployment to a newer version using the bump.sh script:

  • Automated container version upgrade
  • Auto-increment or specify a target patch version
  • Zero-manual-edit process for docker-compose.yml

Prerequisites Summary

Before starting any installation method, ensure you have:

  • Linux distribution: Ubuntu 20.04/22.04
  • Root or sudo privileges on the target server
  • Docker and Docker Compose installed or installable
  • Minimum 16GB RAM
  • 100GB available disk space
  • Network connectivity to machine running scanner for PI System

Installation Time Estimates

Typical installation times by method:

Installation Type Preparation Time Installation Time Total Time
Online Installation 10-20 minutes 20-40 minutes 30-60 minutes
Offline Installation 30-45 minutes 40-60 minutes 70-105 minutes

Times may vary based on server performance, network speed, and environment complexity

Getting Help

If you encounter issues during installation:

  1. Check the troubleshooting sections in each workflow page
  2. Review the verification steps to identify specific problem areas
  3. Consult the support resources listed at the end of each page
  4. Contact Tycho Data support for assistance with complex environments

Next Steps

Start Here: Begin with Pre-flight Checks and Requirements to verify your environment is ready for installation.

After completing the installation workflow, proceed to:

  • Scanner configuration for automated asset discovery
  • Data source connections to your PI System infrastructure
  • User account setup and permissions management
  • Dashboard and monitoring configuration