Skip to content

Windows Installation

This comprehensive guide covers installation of Tycho Data Osprey on Windows Server 2022. The installation process has been broken down into specific workflow stages for easier navigation and implementation.

Installation Overview

Osprey for Windows uses Podman containers and requires WSL2. 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. Post-installation verification and testing
  5. Creating the initial administrator account
  6. Upgrading Osprey to a newer version

Installation Workflow Pages

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

Pre-flight Checks and Requirements

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

  • Hardware and software requirements verification
  • WSL or Hyper-V support and Azure VM considerations
  • Network connectivity testing
  • Prerequisites installation and configuration

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

Option 2: 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

Post-Installation Verification

Verify your installation is working correctly before going live:

  • Local and remote access testing
  • Network connectivity validation

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

Upgrading Osprey

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

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

Next Steps

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