Files
repo-foundry/wiki/SshAndTokens.md
T
Tirsvad 32fa6a819e
Quality checks / quality-checks (pull_request) Successful in 29s
Quality / quality (pull_request) Successful in 29s
Rename the wiki pages without hyphens
Gitea stores a page whose name has a hyphen under an escaped address
(Getting-started.-), which the shared publish workflow does not match, so
the second run tried to create the page again and got HTTP 400. Use
GettingStarted and SshAndTokens, as the wiki of TirSystem/github-action
does.
2026-10-12 18:02:38 +08:00

1.3 KiB

SSH and tokens

SSH access to Gitea

The framework submodule is fetched over SSH on port 10022. Before you run the script:

  1. Add your SSH public key to your Gitea account.

  2. Connect once by hand so the server's host key is known (the script refuses unknown host keys):

    ssh -p 10022 -T git@git.tirsystem.com
    

    A message that you have successfully authenticated, without shell access, means it works.

Passphrase keys. The script never prompts for a passphrase. A key with a passphrase must already be loaded in ssh-agent (ssh-add). This is tracked in issue 77.

Tokens

Token Key in .env Needed Type
Gitea access token GITEA_TOKEN always access token with scopes
GitHub personal access token GITHUB_PAT only when you choose GitHub classic personal access token

Step by step with pictures: how to create the access tokens. The exact permissions are under Token permissions in the README.