Add SSH guide for test panel

Author: grantfitzsimmons

sphinx/index.rst

@@ -34,6 +34,7 @@ Welcome to Specify Developer documentation!
    :caption: Server Management:
 
    server_management/managed_servers
+   server_management/specify_ssh_docker_guide
    server_management/add_user_to_EC2
    server_management/check_asset_usage
    server_management/exoscale

sphinx/server_management/specify_ssh_docker_guide.md

@@ -0,0 +1,154 @@
+# Specify Test Panel User Guide
+
+This guide summarizes how to work with the [Specify 7 Test Panel](https://github.com/specify/specify7-test-panel) as an SSH user.
+
+
+## 🔑 Create and Use SSH Keys for the Specify Test Panel
+
+
+### 1. **Create a Directory for Your Keys**
+
+Open your terminal and run:
+
+```bash
+mkdir -p ~/Documents/specify_keys
+cd ~/Documents/specify_keys
+```
+
+### 2. **Generate a New SSH Key**
+
+Run the following command to create a secure SSH key:
+
+```bash
+ssh-keygen -t rsa -b 2048
+```
+
+- When prompted:  
+  **Enter file in which to save the key:**  
+  Type: `specify_key` and press **Enter**
+
+- When prompted:  
+  **Enter passphrase:**  
+  Press **Enter** (leave empty unless you want to secure it with a passphrase)
+
+- When prompted again:  
+  **Enter same passphrase again:**  
+  Press **Enter**
+
+### 3. **Verify Key Creation**
+
+Run:
+
+```bash
+ls
+```
+
+You should see:
+
+```
+specify_key
+specify_key.pub
+```
+
+### 4. **Copy Your Public Key**
+
+Run:
+
+```bash
+cat specify_key.pub
+```
+
+- Copy the full output.
+- Send this to the person managing the Specify test panel server so they can add your key.
+
+---
+
+## 🖥️ Connect to the Test Panel Server
+
+Once your key has been added, connect by running:
+
+```bash
+ssh -i ~/Documents/specify_keys/specify_key [email protected]
+```
+
+> Replace the path if your folder or key is named differently.
+
+When prompted:
+
+```
+Are you sure you want to continue connecting (yes/no/[fingerprint])?
+```
+
+Type `yes` and press **Enter**.
+
+You are now connected to the **Specify Test Panel**.
+
+---
+
+## 🐳 Docker: View and Access Running Containers
+
+### 1. **See All Running Docker Instances**
+
+Run:
+
+```bash
+docker stats --no-stream
+```
+
+### 2. **Filter by Instance Name**
+
+To search for a specific instance, run:
+
+```bash
+docker stats --no-stream | grep <instance-name>
+```
+
+_Example:_
+
+```bash
+docker stats --no-stream | grep ojsmnh2025-production
+```
+
+### 3. **Access the Container**
+
+Copy the **second column** from the output (example: `specify7-test-panel-osjmnh2025-production-2-1`), then run:
+
+```bash
+docker exec -it <container-name> bash
+```
+
+_Example:_
+
+```bash
+docker exec -it specify7-test-panel-osjmnh2025-production-2-1 bash
+```
+
+Now you're inside the running Docker container.
+
+---
+
+## 🛠️ Django Migrations
+
+### 1. **View List Of All Migrations**
+
+Run:
+
+```bash
+ve/bin/python manage.py showmigrations
+```
+
+- Migrations that have already run will be marked with `[X]`.
+
+### 2. **Run a Migration**
+
+Run:
+
+```bash
+ve/bin/python manage.py migrate <app-name> <migration-name or number>
+```
+
+_Example:_
+
+```bash
+ve/bin/python manage.py migrate specify 0029
+```