#krisyotam forge

Welcome to the documentation wiki for krisyotam forge — a self-hosted SourceHut instance.

#Services

#Getting Started

#1. Account Setup

Your account is managed at meta.krisyotam.com. From there you can:

• Upload SSH public keys for git access
• Upload PGP keys for signed commits and encrypted email
• Configure two-factor authentication
• Generate personal access tokens for the API

#2. Creating a Repository

Navigate to git.krisyotam.com and click Create repository. Repositories can be:

• Public — visible to everyone, listed on hub
• Unlisted — accessible by URL but not listed
• Private — visible only to you and explicit collaborators

Clone and push:

git remote add origin git@git.krisyotam.com:~kris/my-project
git push -u origin main

#3. Continuous Integration

Create a .build.yml manifest in your repository root:

image: alpine/latest
packages:
  - make
  - gcc
tasks:
  - build: |
      cd my-project
      make
  - test: |
      cd my-project
      make test

Builds trigger automatically on push. View results at builds.krisyotam.com.

#4. Issue Tracking

Create a tracker at todo.krisyotam.com. Trackers can receive tickets via the web interface or by email. Labels and milestones help organize work.

#5. Paste / Gist

Share code snippets at gist.krisyotam.com. Pastes support syntax highlighting, expiration, and visibility controls. Useful for sharing configurations, logs, or quick scripts.

#6. Mailing Lists

Set up project mailing lists at lists.krisyotam.com for patch review and discussion. SourceHut's email-driven workflow integrates tightly with git send-email.

#7. Static Pages

Publish static sites from any git repository. Push HTML, Markdown, or a static site generator output to pages and it will be served at pages.krisyotam.com.

#API Access

All services expose a GraphQL API. Authenticate with a personal access token from meta.krisyotam.com/oauth2:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://git.krisyotam.com/api/graphql \
  -d '{"query": "{ me { username } }"}'

#Administration

This instance is maintained by ~kris. Registration is closed. Contact the admin for account requests.