122 lines
3.2 KiB
Markdown
122 lines
3.2 KiB
Markdown
# Accessing This Local Gitea Instance
|
|
|
|
This project lives on a self-hosted [Gitea](https://gitea.io) instance running on the local network / Tailscale.
|
|
|
|
---
|
|
|
|
## 📍 Instance Details
|
|
|
|
| Field | Value |
|
|
|-------|-------|
|
|
| **Web UI** | http://100.79.253.19:3000 |
|
|
| **Tailscale hostname** | `Orson` / `Hagia` / `Theodora` (all resolve to `100.79.253.19`) |
|
|
| **Owner** | `jacob-mathison` |
|
|
| **Gitea version** | 1.26.2 |
|
|
|
|
---
|
|
|
|
## 🔗 Cloning This Repo
|
|
|
|
```bash
|
|
# HTTPS (recommended for Codex / Claude / Cursor)
|
|
git clone http://100.79.253.19:3000/jacob-mathison/llm-tools.git
|
|
|
|
# SSH (if your SSH key is registered in Gitea)
|
|
git clone orson@100.79.253.19:jacob-mathison/llm-tools.git
|
|
```
|
|
|
|
---
|
|
|
|
## 🔑 Authentication
|
|
|
|
### Personal Access Token (PAT)
|
|
Generate one at: **http://100.79.253.19:3000/user/settings/applications**
|
|
|
|
Required scopes: `read:repository`, `write:repository`
|
|
|
|
Once generated, configure git to use it:
|
|
```bash
|
|
git config credential.helper store
|
|
# Then push/pull once — it will prompt for username + PAT
|
|
```
|
|
|
|
Or embed in the remote URL (one-time use, avoid committing):
|
|
```bash
|
|
git clone http://jacob-mathison:<YOUR_PAT>@100.79.253.19:3000/jacob-mathison/llm-tools.git
|
|
```
|
|
|
|
### For CI / Automated Tools
|
|
Set these environment variables:
|
|
```bash
|
|
export GITEA_URL=http://100.79.253.19:3000
|
|
export GITEA_USER=jacob-mathison
|
|
export GITEA_TOKEN=<your-pat>
|
|
```
|
|
|
|
---
|
|
|
|
## 🤖 For Codex / Claude / Cursor
|
|
|
|
### If running on the same Tailscale network:
|
|
The Gitea instance is directly reachable at `http://100.79.253.19:3000`. No tunnel needed.
|
|
|
|
```bash
|
|
# Verify reachability
|
|
curl -s http://100.79.253.19:3000/api/v1/version
|
|
# Should return: {"version":"1.26.2"}
|
|
```
|
|
|
|
### Git config for this remote
|
|
```bash
|
|
git remote add origin http://100.79.253.19:3000/jacob-mathison/llm-tools.git
|
|
git remote set-url origin http://jacob-mathison:<YOUR_PAT>@100.79.253.19:3000/jacob-mathison/llm-tools.git
|
|
```
|
|
|
|
### Pushing changes
|
|
```bash
|
|
git add .
|
|
git commit -m "your message"
|
|
git push origin main
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 Gitea API Quick Reference
|
|
|
|
All API calls use Basic Auth or Bearer token:
|
|
|
|
```bash
|
|
# List repos
|
|
curl -s -u jacob-mathison:<PAT> http://100.79.253.19:3000/api/v1/repos/search | jq '.data[].full_name'
|
|
|
|
# Get repo info
|
|
curl -s -u jacob-mathison:<PAT> http://100.79.253.19:3000/api/v1/repos/jacob-mathison/llm-tools
|
|
|
|
# Create a file
|
|
curl -s -u jacob-mathison:<PAT> -X POST \
|
|
http://100.79.253.19:3000/api/v1/repos/jacob-mathison/llm-tools/contents/example.md \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"message":"add file","content":"'$(echo 'Hello' | base64)'"}'
|
|
|
|
# List branches
|
|
curl -s -u jacob-mathison:<PAT> http://100.79.253.19:3000/api/v1/repos/jacob-mathison/llm-tools/branches
|
|
|
|
# Full API docs (Swagger)
|
|
http://100.79.253.19:3000/api/swagger
|
|
```
|
|
|
|
---
|
|
|
|
## 🏗️ Repository List
|
|
|
|
Browse all repos: **http://100.79.253.19:3000/jacob-mathison**
|
|
|
|
---
|
|
|
|
## ⚠️ Network Notes
|
|
|
|
- **On local LAN:** The machine hosting Gitea is accessible via LAN at the same `100.79.253.19` Tailscale IP
|
|
- **Off-network:** Must be on Tailscale VPN to reach this instance
|
|
- **Tailscale install:** https://tailscale.com/download — ask Jacob for an invite if needed
|
|
- **Port 3000** must not be firewalled if accessing from another LAN machine
|