HPC console documentation

docs/access/hpc-console.md

@@ -0,0 +1,39 @@
+[](){#hpc-console}
+# HPC Console
+
+HPC Console is a web application designed to provide essential functionalities for interacting with [FirecREST API v2 backend][ref-firecrest].
+HPC Console is a web application that provides users with a modern web-based environment to interact with HPC resources such as clusters, job schedulers, and filesystems.
+
+## Features
+
+
+- Dashboard – shows cluster availability and basic system status.
+- Jobs – allows creating, submitting, and monitoring jobs. Users can provide job name, script, and resource requirements.
+- File Navigator – supports browsing directories, uploading, downloading, and deleting files. Editing files inline is not supported.
+
+## Alps platforms
+
+HPC console is currently available on three [Alps platforms][ref-alps-platforms].
+
+| Platform       | URL               | Clusters                                                                 |
+|----------------|----------------------|--------------------------------------------------------------------------|
+| HPC Platform   | [https://my.hpcp.cscs.ch/](https://my.hpcp.cscs.ch/) | [Daint][ref-cluster-daint], [Eiger][ref-cluster-eiger]             |
+| ML Platform    | [https://my.mlp.cscs.ch/](https://my.mlp.cscs.ch/)  | [Bristen][ref-cluster-bristen], [Clariden][ref-cluster-clariden]  |
+| CW Platform    | [https://my.cwp.cscs.ch/](https://my.cwp.cscs.ch/)  | [Santis][ref-cluster-santis]  |
+
+## Access and prerequisites
+
+- Access requires a valid CSCS account and authentication through the institutional login system.
+- Supported browsers: recent versions of Chrome, Firefox, and Safari are recommended.
+- Sessions automatically expire after a period of inactivity.
+
+## Feedback
+
+We welcome your feedback to help us improve HPC Console.
+If you encounter issues or have suggestions, please [let us know][ref-get-in-touch].
+
+## Further information
+
+* [FirecREST UI documentation](https://eth-cscs.github.io/firecrest-ui)
+* [FirecREST UI repository](https://github.com/eth-cscs/firecrest-ui)
+* [FirecREST documentation](https://eth-cscs.github.io/firecrest-v2)

mkdocs.yml

@@ -37,6 +37,7 @@ nav:
     - 'Web Services': access/web.md
     - 'SSH': access/ssh.md
     - 'FirecREST': access/firecrest.md
+    - 'HPC Console': access/hpc-console.md
     - 'JupyterLab': access/jupyterlab.md
     - 'VSCode': access/vscode.md
   - 'Running Jobs':