NL-BIOMERO
1.4.0

Overview

  • Overview Video

System Administration

  • Development & Demo Setup
    • Quick Links to Other Guides
    • Windows Development Setup
      • Prerequisites
      • Quick Setup Steps
    • Container Management
    • Configuration Overview
    • BIOMERO 101 Installation Guide
  • Advanced Deployment Guide
    • NL-BIOMERO Deployment & Upgrade Guide
      • Scenario 0: Development & Demo
      • Scenario 1: Fresh Deployment (no existing data)
      • Scenario 2: Fresh Deployment with Existing Data
      • Scenario 3: Hybrid Deployment with Existing OMERO Server
      • Scenario 4: Full Non-Docker Install (Not Recommended)
      • Notes
      • Next Steps
  • Docker Compose Scenarios
    • NL-BIOMERO Deployment Scenarios and Docker Compose Files
      • Overview
      • Important Usage Note
      • Scenario 0: Development & Demo
        • Scenario 0.1: Local Development Setup
        • Scenario 0.2: Default (Local Build)
      • Scenario 1: Fresh Deployment (no existing data)
        • Scenario 1.1: Standard Production Deployment
        • Scenario 1.2: Production with SSL (Ubuntu)
      • Scenario 2: Fresh Deployment with Existing Data
        • Scenario 2.1: Restore from OMERO Backup
      • Scenario 3: Hybrid Deployment with Existing OMERO Server
        • Scenario 3.1: BIOMERO Only (External OMERO)
        • Scenario 3.2: BIOMERO.importer Only (External OMERO)
      • Additional Configurations
        • Component Selection with Profiles
        • Toggle UI Modules (OMERO.biomero plugin)
        • Environment Customization
      • Creating a Custom Deployment
  • Linux/Ubuntu Deployment
    • NL‑BIOMERO (Ubuntu/Linux) πŸš€
      • 🧰 Prerequisites
      • πŸ”§ Key Differences from Windows Docker Desktop
        • 1. PostgreSQL Image
        • 2. Privileged Access Needed
        • 3. SSH Permissions in biomero-worker
        • 4. Containerized Slurm Build
        • 5. Host Networking (host.docker.internal Replacement)
        • 6. Volume Permission Fixes
        • 7. Secrets & Metabase Setup
        • 8. HTTPS via Nginx Reverse Proxy
        • 9. Persistent Logs
      • βœ… Quick Start (Ubuntu)
      • πŸ› οΈ Troubleshooting Tips
      • 🧠 Lessons Learned
      • πŸ“‹ TL;DR
      • πŸ”— Additional Resources
  • Backup and Restore
    • NL-BIOMERO Backup & Restore Scripts
      • Key Features
      • Quick Start
        • Master Backup (Recommended)
        • Common Options
        • Typical Backup Workflow
        • Typical Restore Workflow
      • Individual Script Usage
        • Database Backup
        • Server Backup
        • Metabase Backup
      • Restore Scripts
      • OMERO Configuration Hierarchy
      • Example: Backup OMERO from Host Folder
      • Example: Backup Metabase from Host Folder
      • Requirements
      • Troubleshooting
      • Help
  • UI Customization
    • Login Page Branding
  • OMERO.biomero Plugin Administration
    • Accessing Admin Interfaces
    • Importer Admin Configuration
      • Group Folder Mappings
      • Configuration File Management
    • Analyzer Admin Configuration
      • Overview
      • Configuration Management
      • Settings Interface Usage
    • Settings Categories
      • SSH Settings
      • SLURM Settings
      • Analytics Settings
      • Converters Settings
      • Models Settings (Workflows)
        • Adding New Workflows
        • Common SBATCH Parameters
        • Editing Existing Workflows
        • Required Follow-up Actions
      • Slurm Check Setup Output
    • Interface Troubleshooting
    • Related Documentation
  • Metabase Administration
    • Overview
    • Initial Security Setup
      • After First Deployment
    • Database Connection Management
      • Adding Database Connections
      • Testing Connections
      • Database Connection Encryption
    • Dashboard Management
      • Standard Dashboards
      • Embedding Configuration
      • Editing Dashboards
    • User Account Management
      • Admin Account
      • Additional Users
    • Backup and Migration
      • Database File Management
      • Upgrading Dashboards
    • Environment Configuration
      • Docker Compose Setup
      • Integration with OMERO.web
    • Security Considerations
      • Network Access
      • Data Protection
    • Troubleshooting
      • Common Issues
      • Performance Issues
    • Related Documentation
  • BIOMERO.analyzer SLURM Integration for NL-BIOMERO
    • Overview
    • Architecture
    • SSH Key Management for Container Deployment
      • Development/Docker Compose Setup
      • Production/Podman Deployment with Secrets
    • Configuration Files
      • Container File Sharing Setup
      • Configuration Content Structure
      • SSH Configuration
    • SLURM Environment Setup
      • Web-Based Configuration (Recommended)
      • Manual SLURM Cluster Setup
    • Security Considerations
      • File Permissions
      • SSH Access Security
      • Database Access
      • Manual Verification
    • Network Security
      • Required Network Access
      • Firewall Configuration
    • Service Account Architecture
      • Single Service Account
      • Account Requirements
    • Deployment-Specific Examples
      • Local Development (docker-compose)
      • Production (Podman with Secrets)
    • Troubleshooting
      • SSH Connection Issues
      • SLURM Job Issues
      • Configuration Validation
    • Further Reading
  • BIOMERO.analyzer + BIOMERO.importer Integration
    • Overview
    • Required configuration changes
      • .env
      • docker-compose.yml β€” biomeroworker service
    • Storage and file-system setup
      • Shared mount
      • Result folder structure
      • Group path resolution
      • Permissions
    • Non-Docker deployments
    • Validating the setup
    • Troubleshooting
    • Related documentation

Developer Guide

  • Architecture Overview
    • System Architecture Diagram
    • Core Components
      • BIOMERO 2.0 Architecture Overview
    • Container Architecture
      • Core Infrastructure
      • BIOMERO Services
    • Data Flow Architecture
      • In-Place Import Pipeline
      • Analysis Pipeline
    • Network Architecture
      • Internal Communication
      • External Access Points
    • Storage Architecture
      • Persistent Storage
      • Remote Storage Integration
    • Compute Integration
      • Demo/Development Environment
      • HPC Integration (Production)
    • Security Architecture
      • Authentication & Authorization
      • Data Protection
    • Monitoring & Analytics
      • Workflow Monitoring
      • Data Analytics
    • Extensibility & Integration
      • Workflow Development
      • API Integration
    • Deployment Scenarios
    • Next Steps
  • Developer Getting Started
    • Quick Setup for Development
    • Development Features
      • Containerized OMERO with BIOMERO
        • Architecture Overview
        • πŸš€ Platform-Specific Deployment
        • Quickstart (Windows)
        • πŸ“Š Data Import
        • 🧬 BIOMERO - BioImage Analysis
        • πŸ› οΈ Container Management
        • πŸ”§ Configuration
        • 🎨 Frontend Customizations
        • οΏ½ Development
        • πŸ“šοΏ½ Additional Resources
        • 🀝 Support
  • Adding Your Workflow to BIOMERO
    • Overview
    • Getting Started
      • Core Documentation
    • Workflow Types & Tutorials
      • CellProfiler Workflows
      • Python Workflows
    • FAIR Workflow Packaging
      • Workshop Materials
      • Real-World Example: Stardist Workflow
    • Additional Resources
      • BIAFLOWS Integration
    • Development Workflow
    • Next Steps
    • Community Support
  • Container Development
    • OMERO Server Container
      • Overview
      • Key Customizations
        • Script Installation
        • Automated Configuration Restoration
      • Dockerfile Key Changes
      • Development Guidelines
        • Configuration Changes
        • Adding New Scripts
        • Testing Changes
      • Related Documentation
    • OMERO Web Container
      • Overview
      • Development Workflow
        • Development Mode
        • OMERO.biomero Plugin Development
      • Key Installed Plugins
        • Core OMERO Plugins
        • Supporting Libraries
      • Custom Interface Modifications
      • Dockerfile Key Sections
      • Development Guidelines
        • Starting Development
        • Making Changes
        • Customizing Login Page with Volume Mounts
        • Testing
      • Related Documentation
    • BIOMERO Worker Container
      • Overview
      • Key Features
      • Container Customizations
        • SSH Integration
        • Database Integration
        • Data Export Pipeline
        • BIOMERO Library Integration
        • Custom Processor Implementation
      • Configuration Management
        • Slurm Configuration
        • Analytics Configuration
      • Worker Startup Process
        • Configuration Generation
      • Development Guidelines
        • BIOMERO Script Development
        • SSH Key Management
        • Configuration Testing
        • Eventsourcing
      • Troubleshooting
        • Common Issues
        • Performance Optimization
      • Upgrade Considerations
        • BIOMERO Library Updates
        • Processor.py Maintenance
      • Related Documentation
      • External Resources
    • Database Containers
      • Overview
      • Key Components
      • Schema customization
      • Migration
      • Performance tuning
      • Backup automation
      • Accessing PostgreSQL
      • Related Documentation
    • Metabase Container
      • Why Metabase?
      • Dashboard Development
        • Access
        • Dashboards in use
        • Embedding in OMERO.web
        • Editing dashboards
        • Adding a new dashboard
        • Browse attached databases
        • Managing database connections
        • User account and password
        • Versioning and migration
        • Upgrading Metabase Dashboards
      • Troubleshooting
        • Common Issues and Solutions
      • Related Documentation
    • BIOMERO.importer Container
      • Overview
      • Import Workflow
      • Import order creation and management
      • File system monitoring and processing
      • Configuration
      • Integration with OMERO server
      • Custom import pipeline development
      • Error handling and retry mechanisms
      • Testing
      • Security and runtime requirements
      • Related Documentation
    • Analyzer β†’ Importer Integration
      • Overview
      • How it works
        • Script selection
        • Permanent storage layout
        • Group base path resolution
        • Permission requirements
        • Upload order and in-place import
        • Progress tracking
      • Infrastructure requirements
        • Shared storage mount
        • Environment variables for biomeroworker
        • Volume mounts for biomeroworker
      • Docker Compose changes
      • Non-Docker deployments
      • Troubleshooting
        • Results end up on OMERO server storage instead of remote storage
        • Upload order created but import never completes
        • Files not found at expected path
        • PermissionError writing to .analyzed folder
        • Import polling times out
      • Related documentation
    • Container Releases
      • Release Overview
      • Release Workflow
        • Container Build Automation
        • Typical Release Process
      • Versioning Guidelines
        • Semantic Versioning
        • Pre-release Versions
        • Release Examples
      • Dependency Management
        • Library Updates
        • Example Dependency Update
      • OMERO ADI Submodule
        • Special Handling
      • Docker Hub Management
        • Container Registry
        • Repository Management
      • Communication & Announcements
        • Release Communication
        • Release Notes Template
      • Troubleshooting Releases
        • Common Issues
        • Emergency Releases
      • Best Practices
        • Release Checklist
        • Release Quality
      • Related Documentation

User Guide

  • Getting Started
    • First Steps with NL-BIOMERO
      • Access the Platform
      • Default Login
      • Next Steps
    • Platform Overview
      • 🧬 BIOMERO - BioImage Analysis
        • Quick Workflow Example:
NL-BIOMERO
  • Search

© Copyright 2025, Core Facility Cellular Imaging.

Built with Sphinx using a theme provided by Read the Docs.
Other Versions v: v1.4
Tags
v1.4 (Latest)
v1.3
v1.2
v1.1
v1