fluxerapp/fluxer
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
d848765cc28bd93fb097684908ea74b78ffcbc0e
fluxer/NOTES.md
Kitty Cat 3ad2ca08c3
Some checks failed
release server / resolve build metadata (push) Successful in 6s
Details
release server / build fluxer server (push) Failing after 1m31s
Details
release server / create release (push) Has been skipped
Details
release server / release summary (push) Failing after 5s
Details
fix(docker): apply critical patches from third-party guide 
Based on https://gist.github.com/PaulMColeman/e7ef82e05035b24300d2ea1954527f10

Changes:
- Add ca-certificates for rustup HTTPS downloads
- Install Rust and WASM toolchain for frontend WebAssembly compilation
- Copy config directory needed for FLUXER_CONFIG env var
- Set FLUXER_CONFIG so rspack can derive API endpoints
- Update ENTRYPOINT to target @fluxer/server package specifically
- Fix .dockerignore to allow build scripts and locale files

These fixes address the most critical build issues documented in the
community guide for self-hosting Fluxer.
2026-03-01 11:12:56 -05:00

3.7 KiB
Raw Blame History

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

git fetch origin
git rebase origin/refactor

Push your changes to Gitea

git push i5 uwu
# If you've rebased, use: git push i5 uwu --force-with-lease

View your changes

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

Gitea Setup Requirements

Container Registry Authentication

The workflow tries to use secrets.GITEA_TOKEN or github.token for registry auth.

Required: Create a Gitea Personal Access Token:

  1. Go to Gitea Settings → Applications → Generate New Token
  2. Name: CI_Container_Registry
  3. Permissions: Select package (write access)
  4. Add to repository secrets as registry_token (Note: Can't use GITEA_ or GITHUB_ prefix)

Alternative: Update the workflow to use username/password:

  • Create a secret REGISTRY_USERNAME with your Gitea username
  • Create a secret REGISTRY_PASSWORD with a personal access token

Container Registry URL Format

Gitea registry format is typically:

  • git.i5.wtf/fluxerapp/fluxer-server:tag

If the registry requires a different format, check your Gitea container registry settings.

TODO

  • Modify GitHub Actions workflows for Gitea compatibility
  • Fix container registry authentication
  • 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

Known Build Issues from Third-Party Guide

The guide documents these critical Dockerfile fixes needed:

  1. ✅ Fix package path (app → app_proxy)
  2. ✅ Add Rust/WASM toolchain (frontend needs WebAssembly)
  3. ✅ Add ca-certificates (for rustup HTTPS download)
  4. ✅ Fix .dockerignore (unblock build scripts and locale files)
  5. ✅ Set FLUXER_CONFIG env var (rspack needs this)
  6. ✅ Copy config directory for build process
  7. ✅ Update ENTRYPOINT to target fluxer_server package

Additional fixes that may be needed (will address if they come up):

  • Empty CDN endpoint handling (frontend code)
  • Content Security Policy adjustments
  • NATS configuration
  • LiveKit webhook configuration