# uwu.lc Self-Hosting Notes

## Branch Setup

**Current branch**: `uwu` (based on `refactor`)
- **Tracks**: `origin/refactor` for rebasing upstream changes
- **Pushes to**: `i5/uwu` on your Gitea instance at git.i5.wtf
- **Current state**: 1 commit ahead (LFS config change)

## Workflow

### Pull upstream changes and rebase
```bash
git fetch origin
git rebase origin/refactor
```

### Push your changes to Gitea
```bash
git push i5 uwu
# If you've rebased, use: git push i5 uwu --force-with-lease
```

### View your changes
```bash
git log origin/refactor..uwu  # Show commits you've added
```

## Why track `refactor` branch?

The `refactor` branch is a complete rewrite that:
- Is simpler and lighter to self-host
- Uses SQLite instead of complex database setup
- Removes payment/Plutonium stuff for self-hosted deployments
- Is much better documented
- Is where active development happens

The old `main`/`canary` branches have the legacy stack that's harder to self-host.

## Configuration Changes Made

1. **LFS Config** (`.lfsconfig`): Updated to point to Gitea instance
   - Old: `https://github.com/fluxerapp-old/fluxer-private.git/info/lfs`
   - New: `https://git.i5.wtf/fluxerapp/fluxer.git/info/lfs`

2. **CI Workflows**: Updated for Gitea compatibility
   - Changed all runners from `blacksmith-8vcpu-ubuntu-2404` to `ubuntu-latest`
   - `ci.yaml`: Main CI workflow (typecheck, test, gateway, knip, ci-scripts)
   - `release-server.yaml`: Docker build workflow
     - Registry: `ghcr.io` → `git.i5.wtf`
     - Image: `fluxerapp/fluxer-server`
     - Trigger branch: `canary` → `uwu`
     - Default source ref: `canary` → `uwu`

## TODO

- [ ] Modify GitHub Actions workflows for Gitea compatibility
- [ ] Apply patches from third-party guide (if needed)
- [ ] Configure for uwu.lc domain
- [ ] Test CI on Gitea instance
- [ ] Build Docker image
- [ ] Deploy to production

## Resources

- Third-party guide: https://gist.github.com/PaulMColeman/e7ef82e05035b24300d2ea1954527f10
- Domain: uwu.lc
- Gitea: git.i5.wtf