Skip to content

Online Installation (Windows)

When to Use Online Installation

Online installation is the recommended method for most users because it:

  • Simplifies the process: Single command downloads and configures everything automatically
  • Ensures latest versions: Always pulls the most current Osprey images and components
  • Reduces errors: Automated script handles complex configuration steps
  • Saves time: No need to manually download and manage installation files

Choose online installation when: - Your server has reliable internet access - You can access Docker Hub and Azure storage endpoints - You want the simplest installation experience - You need the latest version of Osprey

The installation typically takes 5-15 minutes depending on internet speed and server performance.

Installation Steps

Step 1: Install Podman

Ensure WSL2 is enabled and Podman is installed before proceeding. See Pre-flight Checks for WSL2 setup instructions and Podman installation.

Step 2: Run Bootstrap Script

  1. Open PowerShell as Administrator
  2. Run the bootstrap command:
Invoke-WebRequest -Uri "https://tychodataosprey.blob.core.windows.net/images/bootstrap.ps1" -UseBasicParsing | Invoke-Expression

This script will automatically:

  • Download the latest Osprey Docker images
  • Download and configure PostgreSQL database
  • Set up docker-compose configuration
  • Configure Docker networking and ports
  • Initialize the database with required schemas

  • Start all services

  • Run the following to create all necessary database tables:

podman-compose run --rm migrations

Step 3: Test Web Access

Set up account

From a browser, navigate to: http://<server-ip>/start Navigate the set up screens. An initial login will be created for you.

Next Steps

Once the services are running successfully, proceed to the next page to create your administrator account:

Next: Create Administrator Account

Troubleshooting Common Issues

Internet Connectivity Issues

If the script fails to download images:

  • Verify registry access:
Invoke-WebRequest -Uri "https://index.docker.io" -UseBasicParsing
  • Check firewall rules for outbound HTTPS traffic
  • Ensure corporate proxy settings allow Docker Hub access
  • If this does not resolve, attempt to run offline installation

Permission Errors

If you see permission denied errors:

  • Ensure PowerShell is running as Administrator
  • Verify Podman is running with appropriate permissions

Upgrades

To upgrade Osprey to a newer version:

1. Stop Current Services

podman-compose down

2. Update Version in Configuration

Open docker-compose.yml and update the Osprey image version to the latest version provided by the Tycho Data team.

Example:

services:
  app:
    image: tychodata/osprey:1.0.125  # Update to new version number

3. Start Updated Services

podman-compose up -d

4. Verify Upgrade

Check that all containers are running with the new version:

# Check container status
podman-compose ps

# Verify image versions
podman images | findstr osprey

Note: Always backup your configuration and data before performing upgrades.