Variables | Gitea Documentation
Skip to content Variables Environment variables Section titled “Environment variables” These environment variables are set automatically in every workflow run and can be accessed directly (e.g. $CI in shell scripts). Name Description Example CI Always set to true . true GITEA_ACTIONS Always set to true . Useful to distinguish Gitea Actions from other CI systems. true GITEA_ACTIONS_RUNNER_VERSION The version of the runner executing the workflow.
1.0.8 GITEA_DOCKER_WORKSPACE The workspace path as the Docker daemon sees it, for bind mounts into containers a job starts, e.g. ${GITEA_DOCKER_WORKSPACE:-.}/data:/app/data in a compose file. Only set for jobs running in a container. /var/lib/docker/volumes/GITEA-ACTIONS-TASK-42_***/_data GITEA_ENV GITHUB_ENV Path to the file that sets environment variables for subsequent steps. /home/runner/work/_temp/_runner_file_commands/set_env_*** GITEA_OUTPUT GITHUB_OUTPUT Path to the file that sets step output parameters. /home/runner/work/_temp/_runner_file_commands/set_output_*** GITEA_PATH GITHUB_PATH Path to the file that adds system PATH entries for subsequent steps. /home/runner/work/_temp/_runner_file_commands/add_path_*** GITEA_STATE GITHUB_STATE Path to the file that sets step state variables. /home/runner/work/_temp/_runner_file_commands/save_state_*** GITEA_STEP_SUMMARY GITHUB_STEP_SUMMARY Path to the file for writing job summaries. /home/runner/work/_temp/_runner_file_commands/step_summary_*** GITHUB_ACTIONS Always set to true . true GITHUB_ACTION The name of the action currently running, or the step id . __run GITHUB_ACTION_PATH The path where the action is located. /home/runner/work/_actions/actions/checkout/v4 GITHUB_ACTION_REF The ref of the action being executed. v4 GITHUB_ACTION_REPOSITORY The owner and repository of the action. actions/checkout GITHUB_ACTOR The username of the user that triggered the workflow. silverwind GITHUB_API_URL The URL of the REST API. https://gitea.com/api/v1 GITHUB_BASE_REF The target branch of a pull request. main GITHUB_EVENT_NAME The name of the event that triggered the workflow. push GITHUB_EVENT_PATH Path to the file containing the event webhook payload. /home/runner/work/_temp/_github_workflow/event.json GITHUB_GRAPHQL_URL Empty in Gitea (GraphQL is not supported). (empty) GITHUB_HEAD_REF The source branch of a pull request. feature-branch GITHUB_JOB The job_id of the current job. build GITHUB_REF The fully-formed ref that triggered the workflow. refs/heads/main GITHUB_REF_NAME The short ref name. main GITHUB_REF_TYPE The type of ref: branch or tag . branch GITHUB_REPOSITORY The owner and repository name. gitea/docs GITHUB_REPOSITORY_OWNER The repository owner’s username. gitea GITHUB_RETENTION_DAYS The number of days that artifacts are kept, empty when kept forever.
90 GITHUB_RUN_ATTEMPT The attempt number of the workflow run. 1 GITHUB_RUN_ID A unique number for each workflow run. 1234 GITHUB_RUN_NUMBER A unique number for each run of a particular workflow. 42 GITHUB_SERVER_URL The URL of the Gitea instance. https://gitea.com GITHUB_SHA The commit SHA that triggered the workflow. a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2 GITHUB_WORKFLOW The name of the workflow. CI GITHUB_WORKSPACE The default working directory on the runner. /workspace/gitea/docs Runner environment variables Section titled “Runner environment variables” Name Description Example RUNNER_ARCH The architecture of the runner.
X64 RUNNER_OS The operating system of the runner. Linux RUNNER_TEMP Path to a temporary directory on the runner. /tmp RUNNER_TOOL_CACHE Path to the tool cache directory on the runner. /opt/hostedtoolcache Internal environment variables Section titled “Internal environment variables” These are used internally by the runner and actions. They are typically not needed in workflows directly. Name Description Example ACTIONS_CACHE_URL URL for the actions cache service. http://192.168.1.10:8088/ ACTIONS_ID_TOKEN_REQUEST_TOKEN Token for OIDC requests.
Only set when configured. *** ACTIONS_ID_TOKEN_REQUEST_URL URL to request OIDC tokens. Only set when configured. https://gitea.com/login/oauth/access_token ACTIONS_RESULTS_URL URL for storing artifacts. https://gitea.com ACTIONS_RUNTIME_TOKEN Authentication token for the Actions pipeline API. *** ACTIONS_RUNTIME_URL URL for the Gitea Actions pipeline API. https://gitea.com/api/actions_pipeline/ Context variables Section titled “Context variables” These variables are available in workflow expressions via ${{ gitea.<name> }} .
For compatibility, ${{ github.<name> }} works as an alias. Name Description Example gitea.action github.action The name of the action currently running, or the id of a step. __run gitea.action_path github.action_path The path where an action is located. Only supported in composite actions. /home/runner/work/_actions/actions/checkout/v4 gitea.action_ref github.action_ref The ref of the action being executed. v4 gitea.action_repository github.action_repository The owner and repository name of the action. actions/checkout gitea.action_status github.action_status The current result of a composite action. success gitea.actor github.actor The username of the user that triggered the initial workflow run. silverwind gitea.api_url github.api_url The URL of the REST API. https://gitea.com/api/v1 gitea.base_ref github.base_ref The target branch of a pull request.
Only set for pull_request and pull_request_target events. main gitea.env github.env Path on the runner to the file that sets environment variables from workflow commands. Unique to each step. /home/runner/work/_temp/_runner_file_commands/set_env_*** gitea.event github.event The full event webhook payload as an object. See Event payload . {...} gitea.event_name github.event_name The name of the event that triggered the workflow run. push gitea.event_path github.event_path Path on the runner to the file containing the full event webhook payload. /home/runner/work/_temp/_github_workflow/event.json gitea.head_ref github.head_ref The source branch of a pull request.
Only set for pull_request and pull_request_target events. feature-branch gitea.job github.job The job_id of the current job. build gitea.ref github.ref The fully-formed ref that triggered the workflow. refs/heads/main gitea.ref_name github.ref_name The short ref name. main gitea.ref_protected github.ref_protected true if branch protections are configured for the ref that triggered the workflow run. true gitea.ref_type github.ref_type The type of ref: branch or tag . branch gitea.path github.path Path on the runner to the file that sets system PATH variables from workflow commands.
Unique to each step. /home/runner/work/_temp/_runner_file_commands/add_path_*** gitea.repository github.repository The owner and repository name. gitea/docs gitea.repository_owner github.repository_owner The repository owner’s username. gitea gitea.repositoryUrl github.repositoryUrl The HTML URL to the repository. https://gitea.com/gitea/docs gitea.retention_days github.retention_days The number of days that artifacts are kept, empty when kept forever.
90 gitea.run_id github.run_id A unique number for each workflow run within a repository. Does not change on re-run. 1234 gitea.run_number github.run_number A unique number for each run of a particular workflow. Starts at 1 and increments with each new run. 42 gitea.run_attempt github.run_attempt A unique number for each re-run attempt. Starts at 1 and increments with each re-run. 1 gitea.secret_source github.secret_source The source of a secret used in a workflow.
Always Actions in Gitea. Actions gitea.server_url github.server_url The URL of the Gitea instance. https://gitea.com gitea.sha github.sha The commit SHA that triggered the workflow. a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2 gitea.token github.token A token to authenticate on behalf of the Gitea App installed on the repository. See Token permissions . ghs_*** gitea.triggering_actor github.triggering_actor The userna
The rest of this page is on the live site.