Documentation

Updated 2026-05-23

Quick start

⚠️ WARNING Use official Docker installation instead of using snap on Ubuntu, see issue #5 Create the project folder mkdir gisia cd gisia Init the config…

How to run pipelines

1. register a runner 1. config your pipeline 1. login as admin 1. goto /admin/runners 1. click on the button New instance runner 1. click on the button Create…

Managing Issues

This guide covers how to organize and manage issues in your project using labels and boards. Issues are tasks, bugs, or feature requests that need to be…

Using AI Bot Skills

Gisia exposes machine-readable skill files that let AI bots understand and operate your projects through the API. This guide walks you through connecting a bot…

Overriding Project Skills

By default Gisia serves built-in skill files that tell AI bots how to interact with your project. You can replace any of them with your own version by…

Configure SMTP email

By default, Gisia has all email disabled. To send emails, you need to enable email and configure SMTP in your gitlab.yml. Open your config/web/gitlab.yml in…

REST API

Gisia exposes machine-readable skill files at well-known URLs. Instead of reading static API documentation, your AI bot fetches the skill file directly from…

CI YAML Reference

Reference for all CI YAML keywords supported by Gisia. | Keyword | Type | Status | |---------|------|--------| | afterscript | job | Supported | | allowfailure…

Upgrade

Check the releases page for the latest version before upgrading. 1. Change the Gisia version to image: gisia/gisia:VERSION in your docker-compose.yml 2.…

Backup

Gisia must be stopped before taking a backup to ensure data consistency. 1. Stop the services: 2. Archive the Gisia folder: 3. Start the services again:

Metrics

When enabled, this Gisia instance periodically checks for newer versions. 1. Go to Admin → Settings → Metrics 2. Expand the Version Check section 3. Check or…