Add computer setup documentation #271
Conversation
There was a problem hiding this comment.
Pull Request Overview
This PR adds comprehensive documentation for setting up new computers for BBGLab team members, covering both Ubuntu and Windows installations. The documentation provides detailed step-by-step instructions for Ubuntu setup while noting that Windows setup is handled by the IT department.
- Ubuntu installation process with multiple version options and detailed configuration steps
- Software installation procedures including custom BGAdmin script and cluster access setup
- Personal configuration steps for new team members including SSH keys, VPN, and git setup
| 3. Connect the computer to the wired network and click **"Use wired connection"**. Using a wired connection is necessary for later steps. | ||
| 4. Select **"Interactive installation"** and then **"Default installation"**. | ||
| 5. ⚠️**IMPORTANT (see warning below)**⚠️: Select **"Erase disk and install Ubuntu"**. Then, click on **"Advanced features" > "Use LVM and encryption"**. | ||
| 6. Set `bbglab` as the passphrase for the encryption. This will be used to unlock the disk during boot. |
There was a problem hiding this comment.
Using a hardcoded, common passphrase 'bbglab' for disk encryption creates a security risk. Consider using a unique passphrase per installation or providing guidance on generating secure passphrases.
| 6. Set `bbglab` as the passphrase for the encryption. This will be used to unlock the disk during boot. | |
| 6. Create a strong, unique passphrase for the encryption. This passphrase will be used to unlock the disk during boot. We recommend using a passphrase that is at least 12 characters long and includes a mix of uppercase letters, lowercase letters, numbers, and special characters. You can use a passphrase generator or follow [this guide](https://www.passwordmanager.com/generate-secure-password/) for tips on creating a secure passphrase. |
There was a problem hiding this comment.
@FedericaBrando I was thinking now that since the repo is public it might be a problem to include the password here. What do you think?
| - Your name: `Name Surname` | ||
| - Your computer's name: `lopezXX`, where `XX` is the number of the computer (ask the Engineers team of the lab). | ||
| - Pick a username: `nsurname`. **NOTE**: This should be the username of the cluster, which usually is the first letter of your name followed by your surname, but can differ slightly if the username already exists for common names. Check with the Engineers team to make sure which is the correct username. | ||
| - Choose a password: `bbglab`. This password should then be changed by the user after the installation. |
There was a problem hiding this comment.
Using a hardcoded default password 'bbglab' creates a security vulnerability, even if meant to be changed later. Consider using a more secure temporary password or requiring immediate password change during setup.
| - Choose a password: `bbglab`. This password should then be changed by the user after the installation. | |
| - Choose a password: Generate a unique, strong password (e.g., using a password manager). Ensure the password is securely stored and shared only with authorized personnel. The user should change this password if necessary after the installation. |
Create comprehensive documentation for setting up a new computer for BBGLab team members, covering both Ubuntu and Windows installations, necessary software, and configuration steps.