fizzlepoof/truenas-stacks
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(gitea): document internal SSH remote

Browse Source 
Record the working internal Gitea SSH remote as ssh://git@10.5.1.6:2222/<owner>/<repo>.git and replace stale HTTPS/gitea.paccoco.com examples for PD/NOMAD operations. Port 2222 is SSH, while the web UI remains on port 3002.
This commit is contained in:
Fizzlepoof
2026-05-13 17:15:39 +00:00
parent 686de9f543
commit 4d04077f51
4 changed files with 9 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/architecture/ARCHITECTURE_OVERVIEW.md
View File

@@ -24,7 +24,7 @@ Full homelab stack as of 2026-05-09. All 6 expansion phases are complete and dep
- **Homepage** (3300) — dashboard / service index - **Homepage** (3300) — dashboard / service index
- **Uptime Kuma** (3001) — monitoring and alerting - **Uptime Kuma** (3001) — monitoring and alerting
- **Gotify** (8443) — push notifications - **Gotify** (8443) — push notifications
- **Gitea** (3002) — self-hosted git - **Gitea** (3002 web / 2222 SSH) — self-hosted git; internal SSH remote uses `ssh://git@10.5.1.6:2222/<owner>/<repo>.git`
- **Dockhand** (3230) — Docker management UI - **Dockhand** (3230) — Docker management UI
### AI Layer ### AI Layer
@@ -61,4 +61,4 @@ Full homelab stack as of 2026-05-09. All 6 expansion phases are complete and dep
3. **External Docker networks** — `ai-services` bridges all AI containers across compose files; `ix-databases_shared-databases` provides shared DB access 3. **External Docker networks** — `ai-services` bridges all AI containers across compose files; `ix-databases_shared-databases` provides shared DB access
4. **NFS for Immich** — photo library lives on Serenity's large array; PD mounts on demand (not at boot) 4. **NFS for Immich** — photo library lives on Serenity's large array; PD mounts on demand (not at boot)
5. **TrueNAS manages Docker** — never use `systemctl restart docker` on PD; use `docker compose` or `docker restart` for individual containers 5. **TrueNAS manages Docker** — never use `systemctl restart docker` on PD; use `docker compose` or `docker restart` for individual containers
6. **Credential hygiene** — Gitea remote uses HTTPS + credential store; GitHub remote uses SSH key (`/root/.ssh/id_gitea`) 6. **Credential hygiene** — Gitea pushes from PD/NOMAD use internal SSH (`ssh://git@10.5.1.6:2222/<owner>/<repo>.git`); GitHub remote uses SSH key (`/root/.ssh/id_gitea`)

2
docs/architecture/SERVICES_DIRECTORY.md
View File

@@ -20,7 +20,7 @@ All homelab services, their hosts, ports, and current status.
| Dockhand | 3230 | http://pd:3230 | ✅ Active | | Dockhand | 3230 | http://pd:3230 | ✅ Active |
| Uptime Kuma | 3001 | http://pd:3001 | ✅ Active | | Uptime Kuma | 3001 | http://pd:3001 | ✅ Active |
| Gotify | 8443 | https://pd:8443 | ✅ Active | | Gotify | 8443 | https://pd:8443 | ✅ Active |
| Gitea | 3002 / 2222 | http://pd:3002 (SSH: 2222) | ✅ Active | | Gitea | 3002 / 2222 | http://pd:3002 / http://10.5.1.6:3002 (SSH: `ssh://git@10.5.1.6:2222/<owner>/<repo>.git`) | ✅ Active |
| Shlink | 8087 | http://pd:8087 | ✅ Active | | Shlink | 8087 | http://pd:8087 | ✅ Active |
| Shlink Web Client | 8088 | http://pd:8088 | ✅ Active | | Shlink Web Client | 8088 | http://pd:8088 | ✅ Active |
| RackPeek | 8283 | http://pd:8283 | ✅ Active | | RackPeek | 8283 | http://pd:8283 | ✅ Active |

2
docs/operations/SECRETS_MANAGEMENT.md
View File

@@ -172,7 +172,7 @@ On a fresh PD after reinstalling TrueNAS:
``` ```
4. **Clone the main stacks repo:** 4. **Clone the main stacks repo:**
```bash ```bash
git clone git@gitea.paccoco.com:fizzlepoof/truenas-stacks.git /mnt/docker-ssd/docker/compose git clone ssh://git@10.5.1.6:2222/fizzlepoof/truenas-stacks.git /mnt/docker-ssd/docker/compose
``` ```
5. **Redeploy stacks** per `DEPLOYMENT_CHECKLIST.md` 5. **Redeploy stacks** per `DEPLOYMENT_CHECKLIST.md`

7
docs/operations/STACK_STANDARDS.md
View File

@@ -5,7 +5,10 @@
Remotes: Remotes:
- GitHub: `git@github.com:Paccoco/truenas-stacks.git` - GitHub: `git@github.com:Paccoco/truenas-stacks.git`
- Gitea: `https://gitea.paccoco.com/fizzlepoof/truenas-stacks.git` - Gitea web: `http://10.5.1.6:3002/fizzlepoof/truenas-stacks`
- Gitea SSH: `ssh://git@10.5.1.6:2222/fizzlepoof/truenas-stacks.git`
Use the internal Gitea SSH remote from PD/NOMAD. Port `2222` is SSH, not HTTP.
## Stack Layout ## Stack Layout
Each production stack lives in a subdirectory of the repo root. Each production stack lives in a subdirectory of the repo root.
@@ -116,7 +119,7 @@ After changing a healthcheck, must `down` then `up` (not just restart).
cd /mnt/docker-ssd/docker/compose cd /mnt/docker-ssd/docker/compose
git add . git add .
git commit -m "description" git commit -m "description"
git push # pushes to both GitHub and Gitea git push ssh://git@10.5.1.6:2222/fizzlepoof/truenas-stacks.git main
``` ```
All `.env` files are gitignored. Only compose files, `.env.example`, and init scripts are committed. All `.env` files are gitignored. Only compose files, `.env.example`, and init scripts are committed.