Documentation
Live demo
Contact
Available plugins

What is PERSEUS?

PERSEUS is currently in beta. Some features are still experimental and maybe don't work as expected. Feel free to reach out to us and share you experiences and feedback: https://perseus-project.pc2.uni-paderborn.de/contact/

PERSEUS is a compute project management software for scientific HPC centers. It allows you to

• professionalize your workflows
• deploy center-wide automation
• fully customize workflow items (states), (micro)services and reports

Here’s a first look at the software:

What's new?

Version 27.1.0 includes the following updates:

PERSEUS

• Added
  • Bulk operations for the DatabaseManager
  • Users with the OWNER role can now unassign any task, not only tasks assigned to themselves
  • State machine support for the Project Create service
  • New "Assigned tasks" dashboard widget showing the current user's open tasks
  • New API endpoint to fetch all assigned tasks for the current user
  • Search presets in Project Search
  • Parent/children resource hierarchy in the Project Details view
  • Configurable display fields for project search results
• Fixed
  • PushState.get_tasks() no longer raises a TypeError when called with the include_form keyword argument
  • The login page is now displayed correctly after a session becomes invalid, instead of leaving the re-login modal on screen
  • An error message is now shown when attempting to assign a task that has already been assigned, and the task list refreshes to reflect the current assignment

Andromeda

• Added
  • A user-facing message is now displayed when the server returns a 429 (too many requests) error, prompting the user to retry after a short wait

Click here to view the complete changelog.

Getting Started

There are multiple ways to run PERSEUS. You can either use our automated installer scripts or deploy it manually using Docker or Podman.

Installer & Updater

If you prefer an automated setup that installs all dependencies and configures the environment for you, we provide installer scripts that set up Docker or Podman, along with Nginx and required configuration files.

Compared to the manual docker-compose approach, the installer scripts offer a more opinionated, out-of-the-box experience – ideal for quick testing, small-scale deployments, or first-time users.

We currently offer two variants:

• installer-docker.sh – for Docker-based setups (requires root)
• installer-podman.sh – for Podman-based setups (runs containers as a dedicated non-root user)

The scripts support most major Linux distributions and will automatically detect your package manager.

To keep your deployment up to date, we also provide:

• updater-docker.sh
• updater-podman.sh

These update scripts stop the running containers, pull the latest images, restart the services, and clean up unused resources.

📖 Read more about the installer workflow in our official documentation

Run via Docker

We also provide a ready-to-use docker-compose.yml to run PERSEUS using Docker or Podman.

Our prebuilt container images are available on Docker Hub.

⚠️ Note: This approach requires you to set up a reverse proxy (e.g. Nginx, Traefik, or Caddy) yourself to route requests to the frontend and backend containers. We recommend serving the API under '/api' and the frontend at '/'.

📖 To learn more about this installation method, visit the official documentation.

Components

PERSEUS comes with the following components:

• PERSEUS core
• PERSEUS frontend
• PERSEUS worker
• Plugins (states, services & reports)

License

This project is licensed under the terms of the MIT License. See the LICENSE file for details.