Janus

A multi-user web interface for High Performance Computing clusters, integrating CILogon for authentication and slurmrestd for job management.

Setup Instructions

Prerequisites

1. Docker & Docker Compose
2. A registered CILogon Client (https://cilogon.org/oauth2/register)
   • Callback URI: http://localhost:5173/callback

Configuration

Create a .env file in backend/.

#Database Configuration
DATABASE_URL=postgresql://slurmuser:slurmpassword@db:5432/slurmportal

#CILogon / OIDC Settings
CILOGON_CLIENT_ID=your_cilogon_client_id_here
CILOGON_CLIENT_SECRET=your_cilogon_secret_here
CILOGON_REDIRECT_URI=http://localhost:5173/callback
OIDC_ISSUER=https://cilogon.org

#Security Settings
FRONTEND_ORIGIN=http://localhost:5173
SECRET_KEY=change_this_to_a_long_random_string_in_production

#SLURM Connection
#For local dev without a real cluster, set MOCK_SLURM=true
MOCK_SLURM=true
SLURMRESTD_URL=http://slurm-host:6820
SLURMRESTD_VERSION=v0.0.40

🚀 Getting Started

1. Build and Run:

   docker-compose up --build
   

2. Access the Application:

   • Frontend: Open http://localhost:5173 in your browser.
   • API Docs: Open http://localhost:8000/docs to see the Swagger UI.

3. Login:

   • Click "Log in with CILogon".
   • Select an identity provider (e.g., Google, ORCID, or your University).
   • Upon success, you will be redirected to the Job Dashboard.