Overview
Before you can use Ticket House with a repository, you need to register a project on your Ticket House server. This creates the project record that your local workstation will connect to.
Create a Project in the Web UI
Open your Ticket House server in a browser and navigate to the project creation page. You'll need to provide:
| Field | Description | Example |
|---|---|---|
| Name | Display name for the project | My App |
| Slug | Short identifier used in URLs | my-app |
| Ticket Prefix | Short prefix for ticket IDs | MA (produces MA-1, MA-2, ...) |
| Repository URL | The Git remote URL for the project | git@github.com:org/my-app.git |
After Creation
Once your project is created, note its URL — it will look like:
https://your-server.example.com/projects/my-appYou'll use this URL as the remote value in your .ticket-house.json configuration file. See Configuring a Project for details.
Project Settings
After creating a project, you can configure additional settings from the project's settings page:
- AI assignments — configure which AI providers, models, and personas are available for the project
- Environments — add links to staging, production, or other deployed instances
- Webhooks — set up CI/CD integrations for build status reporting
- Team members — manage who has access to the project