Deployment

Production deployment guide for MokoGitea.

Environments

Environment	URL	Image
Production	`git.mokoconsulting.tech`	`mokogitea:v1.26.1-moko.06.21.00`
CDN	`cdn.mokoconsulting.tech`	(proxies to production)
Dev	`git.dev.mokoconsulting.tech`	dev build

Dev Deploy Gate

All deployments go through the dev environment first. The deploy-dev.yml workflow:

Builds and deploys to dev environment
Runs health check against dev
Only after dev passes does production deployment proceed

Manual Deploy

# SSH to server
ssh -p 2918 mokoconsulting@git.mokoconsulting.tech

# Pull latest
cd /opt/gitea/source && git fetch origin main && git reset --hard origin/main

# Build
docker build --build-arg GOFLAGS='-p 1' --tag mokogitea:TAGHERE -f Dockerfile .

# Update compose and restart
cd /opt/gitea && sed -i 's|mokogitea:.*|mokogitea:TAGHERE|' docker-compose.yml && docker compose up -d mokogitea

Automated Deploy

CI/CD workflows handle deployment automatically on merge to main:

deploy-dev.yml -- builds and deploys to dev
Health check verifies dev is running
deploy.yml -- deploys to production
ci-issue-reporter.yml -- reports failures as issues

Authored by Jonathan Miller (@jmiller) - 2026-06-07, updated 2026-06-26

Pages