4e36cca637
- Update README, AGENTS.md, docs/index.md, docs/deployment/cd.md, docs/services/forgejo.md: replace deploy-rs with Comin everywhere - Fix repo URL references (cryodev-server -> cryodev) - Fix forgejo admin create command to use shell alias - Rewrite cd.md for Comin-only deployment
2.3 KiB
2.3 KiB
Forgejo
Forgejo is a self-hosted Git service (fork of Gitea) with built-in CI/CD Actions.
References
Setup
DNS
Set a CNAME record for git.cryodev.xyz pointing to your main domain.
Configuration
# hosts/cryodev-main/services/forgejo.nix
{ config, ... }:
{
services.forgejo = {
enable = true;
settings = {
server = {
DOMAIN = "git.cryodev.xyz";
ROOT_URL = "https://git.cryodev.xyz";
};
mailer = {
ENABLED = true;
FROM = "forgejo@cryodev.xyz";
};
};
};
}
Forgejo Runner
The runner executes CI/CD pipelines defined in .forgejo/workflows/.
Get Runner Token
- Go to Forgejo Admin Panel
- Navigate to Actions > Runners
- Create a new runner and copy the token
Add to Secrets
sops hosts/cryodev-main/secrets.yaml
forgejo-runner:
token: "your-runner-token"
Configuration
{
sops.secrets."forgejo-runner/token" = { };
services.gitea-actions-runner = {
instances.default = {
enable = true;
url = "https://git.cryodev.xyz";
tokenFile = config.sops.secrets."forgejo-runner/token".path;
labels = [ "ubuntu-latest:docker://node:20" ];
};
};
}
CI/CD Workflows
CI runs on every push to main via Forgejo Actions:
- flake-check -- validates the flake
- build-hosts -- builds all host configurations
Deployment is handled by Comin (pull-based), not by CI. See CD documentation for details.
Administration
Create Admin User
forgejo admin user create \
--username <benutzername> \
--email <email>@<domain> \
--password <passwort> \
--admin
Reset User Password
sudo -u forgejo forgejo admin user change-password \
--username USER \
--password NEWPASS
Troubleshooting
Check Service Status
sudo systemctl status forgejo
sudo systemctl status gitea-runner-default
View Logs
sudo journalctl -u forgejo -f
sudo journalctl -u gitea-runner-default -f
Database Issues
Forgejo uses SQLite by default. Database location:
ls -la /var/lib/forgejo/data/