Welcome to Agora’s documentation!

Administrator Documentation

• 1. Server Requirements
  • 1.1. Hardware
  • 1.2. Software
  • 1.3. Docker
  • 1.4. Proxy
• 2. Installation using the Wizard
  • 2.1. Prepare Installation
    • 2.1.1. Internet access
    • 2.1.2. License
    • 2.1.3. Storage
  • 2.2. Start Installation
  • 2.3. Agora configuration
  • 2.4. Useful commands
    • 2.4.1. Wizard
    • 2.4.2. Start Agora
    • 2.4.3. Stop Agora
    • 2.4.4. Update Agora
    • 2.4.5. Update the Agora Installer
    • 2.4.6. Diagnose
• 3. Manual installation
  • 3.1. Step-by-Step Instructions
  • 3.2. Docker Registry
  • 3.3. Configuration
    • 3.3.1. Time zone
    • 3.3.2. Docker user
    • 3.3.3. Dicom node
    • 3.3.4. Create the docker-compose configuration
    • 3.3.5. Create the docker-compose configuration
  • 3.4. Data storage
    • 3.4.1. Docker Volumes
  • 3.5. Data storage
    • 3.5.1. Docker Volumes
    • 3.5.2. Using NFS
  • 3.6. Start Agora
  • 3.7. Stop Agora
• 4. Installation on Kubernetes
  • 4.1. Step-by-Step Instructions
• 5. Post installation tasks
  • 5.1. License
  • 5.2. Email Settings
  • 5.3. Hostname
  • 5.4. Dicom Node
  • 5.5. Webserver Certificate
  • 5.6. Global Hosts
  • 5.7. Useful Docker commands
  • 5.8. Setup an SSH Task Container
    • 5.8.1. Overview
    • 5.8.2. Architecture
    • 5.8.3. Example config snippet
    • 5.8.4. Key points
    • 5.8.5. How to apply
    • 5.8.6. Connecting from Agora
    • 5.8.7. Connecting from within the Agora app container
    • 5.8.8. Optional: publish to host
    • 5.8.9. Troubleshooting
• 6. Maintain Agora
  • 6.1. Update Agora
  • 6.2. Update with the possibility to return to the previous version
  • 6.3. Update to a specific version
  • 6.4. Update Agora-Installer
  • 6.5. Move data
• 7. Backup
  • 7.1. Backup Configuration
  • 7.2. Backup Data Files
  • 7.3. Backup Databases
  • 7.4. Restore
    • 7.4.1. Download the Agora Installer
    • 7.4.2. Restore Agora Configuration
    • 7.4.3. Create the Agora Volumes
    • 7.4.4. Rebuild the docker-compose file and pull the Agora images:
    • 7.4.5. Restore the Data Files
    • 7.4.6. Restore the Agora Database (Postgres)
    • 7.4.7. Restore the Parameter Database (MongoDB)
    • 7.4.8. Start Agora
• 8. Management Tasks
  • 8.1. Create a new superuser
• 9. Optimize Agora
  • 9.1. Database
• 10. Administration Settings
  • 10.1. General Settings
    • 10.1.1. Hostname
    • 10.1.2. Registration
    • 10.1.3. Authentication
    • 10.1.4. Single Sign-On (SSO)
    • 10.1.5. Error Logging
    • 10.1.6. User Feedback
    • 10.1.7. Download
  • 10.2. Mail Settings
  • 10.3. User Management
  • 10.4. Global Hosts
  • 10.5. DICOM Auto-Routing
  • 10.6. Task Queue
  • 10.7. Logs
  • 10.8. Impersonate User
  • 10.9. Admin Mode
  • 10.10. License
• 11. Appendix
  • 11.1. Using a Proxy Sevrer
    • 11.1.1. Configure Linux to use a proxy
    • 11.1.2. CA certificates
    • 11.1.3. apt-get (Ubuntu)
    • 11.1.4. yum (RHEL, CentOS)
    • 11.1.5. Docker Service
    • 11.1.6. Sudo

User Documentation

• 1. Introduction
  • 1.1. Signing up for an account
  • 1.2. Signing in
• 2. Getting Started
  • 2.1. Dashboard
  • 2.2. Main Menu Bar
  • 2.3. Status Bar
  • 2.4. MyAgora Project
  • 2.5. Customizing your account
  • 2.6. Install AgoraApp
• 3. Projects
  • 3.1. Project Groups
  • 3.2. Project Page
  • 3.3. Project Menu
    • 3.3.1. Folder Tree
    • 3.3.2. Study List
    • 3.3.3. Patient List
    • 3.3.4. Recently Used Items
    • 3.3.5. Search and Queries
    • 3.3.6. Timeline
    • 3.3.7. Tasks
    • 3.3.8. Triggers
    • 3.3.9. Project Settings
    • 3.3.10. Trash Box
• 4. Agora Data Model
  • 4.1. Parameter Sets
  • 4.2. Data Upload vs. Data Import
  • 4.3. Segmented Data Import
  • 4.4. Data Storage and Project Isolation
    • 4.4.1. File-Level Sharing (Copy-on-Write)
  • 4.5. Duplicate Import Behaviour
    • 4.5.1. Study and Series Merging
    • 4.5.2. Dataset and File Deduplication
    • 4.5.3. Special Cases
• 5. Importing Data to Agora
  • 5.1. Elements of a data import
  • 5.2. Upload Data over the Browser
  • 5.3. Upload Data directly from an MR scanner
    • 5.3.1. Philips Platform
  • 5.4. Import from Bruker scanners
  • 5.5. Import from Siemens scanners
  • 5.6. Import from GE scanners
  • 5.7. DICOM Data Transfer
  • 5.8. Upload Data from the command line
  • 5.9. Upload Data using Python
  • 5.10. Upload Data using MATLAB
  • 5.11. Custom Import with a Manifest File
    • 5.11.1. Manifest File Format
    • 5.11.2. Minimal Example
    • 5.11.3. Using the Python Connector
• 6. Data Download and Export
  • 6.1. Download via the Browser
  • 6.2. Download with the Agora App
  • 6.3. Download with Python
  • 6.4. Download with MATLAB
• 7. Managing Data
  • 7.1. Creating a Folder
  • 7.2. Creating Studies and Series
  • 7.3. Adding a dataset to an existing series
    • 7.3.1. Limitations
  • 7.4. Selecting Items
  • 7.5. Detail Panel
  • 7.6. Organization Within a Project
  • 7.7. Quick Search and Filtering
  • 7.8. Query Folders
    • 7.8.1. Attaching a Query
    • 7.8.2. Synchronizing a Query Folder
    • 7.8.3. Managing Attached Queries
    • 7.8.4. Constraints
  • 7.9. Tags and Rating
    • 7.9.1. Tags
    • 7.9.2. Rating
  • 7.10. Favorites
  • 7.11. Selection Set
  • 7.12. Editing Objects
  • 7.13. Dataset Versions
    • 7.13.1. Viewing Versions
    • 7.13.2. Restoring a Version
    • 7.13.3. Deleting a Version
    • 7.13.4. Enabling and Disabling Versioning
  • 7.14. Deleting Objects
  • 7.15. Copying Objects to Another Project
  • 7.16. Moving Objects
  • 7.17. Copying Objects to a Remote Agora Instance
  • 7.18. Merging Projects
• 8. Viewer
  • 8.1. Single Viewer
  • 8.2. Multi-Viewer
  • 8.3. Supported Formats
  • 8.4. Navigation
  • 8.5. Toolbar
  • 8.6. Workbooks
  • 8.7. 3D Viewer
  • 8.8. Spectroscopy Viewer
• 9. Database Search
  • 9.1. Quick Search
  • 9.2. Database Queries
    • 9.2.1. Basic Syntax
    • 9.2.2. Fields
    • 9.2.3. Comparison Operators
    • 9.2.4. Values
    • 9.2.5. Date Fields
    • 9.2.6. Count Queries
    • 9.2.7. Parameter Queries
    • 9.2.8. Examples
    • 9.2.9. Saved Queries
• 10. Hosts
  • 10.1. Adding a Host
  • 10.2. Host Types
    • 10.2.1. SSH Server
    • 10.2.2. Docker Repository
    • 10.2.3. DICOM Node
    • 10.2.4. Agora Server
  • 10.3. Authentication
  • 10.4. Testing the Connection
  • 10.5. Global Hosts
• 11. Tasks
  • 11.1. UI Tasks
    • 11.1.1. Task Name
    • 11.1.2. Execution Target
    • 11.1.3. Container
    • 11.1.4. Inputs
    • 11.1.5. Command Line
    • 11.1.6. Additional Parameters
    • 11.1.7. Examples
  • 11.2. Script Tasks
    • 11.2.1. Structure
    • 11.2.2. Stages
    • 11.2.3. Inputs
    • 11.2.4. Job Fields
    • 11.2.5. Artifacts
    • 11.2.6. Template Variables
    • 11.2.7. Examples
  • 11.3. Where Tasks Run
    • 11.3.1. Local Tasks
    • 11.3.2. Host Server Tasks
    • 11.3.3. Containers (Docker and Podman)
  • 11.4. Monitoring Task Output
  • 11.5. Task Results
  • 11.6. Batch Mode
  • 11.7. Task Templates
  • 11.8. How-To Guides
    • 11.8.1. Setup and perform a Philips Recon 2.0 reconstruction
• 12. Triggers
  • 12.1. Overview
  • 12.2. Events
  • 12.3. Selectors
  • 12.4. Python Script Filter
    • 12.4.1. Script structure
    • 12.4.2. The context dictionary
    • 12.4.3. Script filter examples
  • 12.5. Actions
    • 12.5.1. Link to folder / Copy to project
    • 12.5.2. Run task
    • 12.5.3. Rename
    • 12.5.4. Add Tag
    • 12.5.5. Remove Tag
    • 12.5.6. Log Message
    • 12.5.7. Send Email
    • 12.5.8. Python Script
  • 12.6. Project Counters
    • 12.6.1. Using counters in Jinja2 templates
    • 12.6.2. Using counters in Python scripts
  • 12.7. Developing and Debugging Python Scripts
  • 12.8. Trigger History
• 13. Showcases
  • 13.1. Creating a Showcase
  • 13.2. Adding Objects
  • 13.3. Managing Access
  • 13.4. Viewing Showcases
  • 13.5. Expiration
• 14. User Profile and Settings
  • 14.1. Profile
    • 14.1.1. Identification
    • 14.1.2. Password
    • 14.1.3. API Key
    • 14.1.4. Date and Time Format
  • 14.2. Appearance
  • 14.3. Agora App
  • 14.4. Information
  • 14.5. Downloads

Developer Documentation

• 1. Developer Manual
  • 1.1. Agora REST Interface
  • 1.2. Agora API Libraries
• 2. REST API
  • 2.1. Authentication
  • 2.2. Pagination
  • 2.3. Projects
  • 2.4. Folders
  • 2.5. Studies (Exams)
  • 2.6. Series
  • 2.7. Datasets
  • 2.8. Uploading Data
  • 2.9. Downloading Data
  • 2.10. Tasks
  • 2.11. Search
  • 2.12. Current User
• 3. Python API Library
• 4. Matlab API Library

About

• Changelog
  • [7.19.1] - 2026-04-10
    • Added
    • Fixed
  • [7.18.3] - 2026-03-19
    • Added
    • Changed
  • [7.18.2] - 2026-02-17
    • Added
    • Fixed
  • [7.18.1] - 2025-12-16
    • Added
    • Fixed
    • Changed
  • [7.17.1] - 2025-10-24
    • Changed
  • [7.17.0] - 2025-10-15
    • Added
    • Fixed
  • [7.16.1] - 2025-06-24
    • Added
    • Fixed
  • [7.16.0] - 2025-05-26
    • Added
  • [7.15.3] - 2025-05-14
    • Added
    • Fixed
    • Changed
  • [7.14.0] - 2025-02-13
    • Added
    • Fixed
    • Changed
  • [7.13.1] - 2025-01-07
    • Added
    • Fixed
    • Changed
  • [7.12.7] - 2024-12-17
    • Fixed
    • Changed
  • [7.12.6] - 2024-11-24
    • Added
    • Fixed
  • [7.12.2] - 2024-10-21
    • Added
    • Changed
    • Fixed
  • [7.12.1] - 2024-10-03
    • Changed
    • Fixed
  • [7.12.0] - 2024-09-27
    • Added
    • Changed
    • Fixed
  • [7.11.6] - 2024-08-29
    • Added
    • Changed
    • Fixed
  • [7.11.5] - 2024-07-17
    • Changed
  • [7.11.4] - 2024-07-17
    • Changed
  • [7.11.3] - 2024-07-16
    • Changed
    • Fixed
  • [7.11.2] - 2024-07-10
    • Changed
  • [7.11.1] - 2024-07-05
    • Changed
  • [7.11.0] - 2024-07-04
    • Added
    • Changed
  • [7.10.4] - 2024-04-30
    • Changed
  • [7.10.3] - 2024-04-29
    • Fixed
  • [7.10.2] - 2024-04-26
    • Fixed
  • [7.10.1] - 2024-04-25
    • Fixed
  • [7.10.0] - 2024-04-24
    • Added
    • Fixed
  • [7.9.15] - 2024-04-19
    • Added
    • Fixed

Indices and tables

• Index

• Module Index

• Search Page