Documentation and user guide for the Durga computing server.
This project provides a practical guide for researchers, students, developers, and scientific computing users working on Linux-based remote servers. While the documentation was originally written for the Durga server at the Faculty of Mathematics, Astronomy, Physics and Computing (FaMAF), National University of Córdoba, many sections are applicable to other academic, research, and high-performance computing environments.
The guide covers topics such as:
- Secure SSH access.
- File transfer between local and remote machines.
- JupyterLab remote workflows.
- Long-running computations with tmux.
- Software environments.
- Troubleshooting common issues.
- Best practices for scientific computing.
The latest version of the documentation is available online:
- GitHub Pages:
https://juniors90.github.io/server-user-guide/ - Read the Docs:
https://server-user-guide-durga-famaf.readthedocs.io/en/latest/
This guide is intended for:
- Undergraduate and graduate students.
- Researchers.
- Scientific computing users.
- Developers working on remote Linux systems.
- New users of institutional computing infrastructure.
Although examples are based on the Durga server, the workflows described here are largely platform-independent and may be adapted to other servers.
This repository documents recommended workflows and user procedures.
It is not an administration manual and does not describe server deployment, maintenance, security policies, backups, or infrastructure management.
Juan David Ferreira
Department of Mathematics Faculty of Mathematics, Astronomy, Physics and Computing (FaMAF) National University of Córdoba
Email:
david.ferreira@mi.unc.edu.ar
The author of this documentation is a user of the server and is not a system administrator.
Questions regarding:
- User accounts.
- Passwords.
- Access permissions.
- Resource allocation.
- Hardware failures.
- System outages.
- Administrative policies.
should be directed to the official server administrators and not to the documentation author.
For official support, infrastructure issues, or account-related requests, please contact the corresponding system administration team.
Replace this section with the official contact information for your institution.
Example:
- System Administration Team
- support@example.edu
- https://example.edu
Contributions that improve the documentation are welcome.
Examples include:
- Fixing errors.
- Improving explanations.
- Updating commands.
- Adding examples.
- Reporting broken links.
Please open an issue or submit a pull request.
Create a virtual environment:
python -m venv .venv
source .venv/bin/activateInstall dependencies:
pip install toxBuild the documentation:
tox -e docsThe generated HTML pages will be available under:
docs/build/html/
This documentation is distributed under the MIT License unless stated otherwise.
See the LICENSE file for details.
This documentation was developed to support scientific computing activities at FaMAF and to simplify the onboarding process for new users of academic computing infrastructure.