---
name: "git-bug-bridge-new"
section: "1"
platform: "linux"
package: "git-bug"
version: "0.11.0-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/git-bug-bridge-new"
---

# git-bug-bridge-new(1)

Configure a new bridge

## NAME

git-bug-bridge-new - Configure a new bridge

## SYNOPSIS

**git-bug bridge new \[flags\]**

## DESCRIPTION

Configure a new bridge by passing flags or/and using interactive terminal prompts. You can avoid all the terminal prompts by passing all the necessary flags to configure your bridge.

## OPTIONS

**-n**, **--name**=""\
 	A distinctive name to identify the bridge

**-t**, **--target**=""\
 	The target of the bridge. Valid values are \[github,gitlab,jira,launchpad-preview\]

**-u**, **--url**=""\
 	The URL of the remote repository

**-b**, **--base-url**=""\
 	The base URL of your remote issue tracker

**-l**, **--login**=""\
 	The login on your remote issue tracker

**-c**, **--credential**=""\
 	The identifier or prefix of an already known credential for your remote issue tracker (see "git-bug bridge auth")

**--token**=""\
 	A raw authentication token for the remote issue tracker

**--token-stdin**\[=false\]\
 	Will read the token from stdin and ignore --token

**-o**, **--owner**=""\
 	The owner of the remote repository

**-p**, **--project**=""\
 	The name of the remote repository

**--non-interactive**\[=false\]\
 	Do not ask for user input

**-h**, **--help**\[=false\]\
 	help for new

## EXAMPLE

```
# Interactive example
[1]: github
[2]: gitlab
[3]: jira
[4]: launchpad-preview
target: 1
name [default]: default
Detected projects:
[1]: github.com/git-bug/git-bug
[0]: Another project
Select option: 1
[1]: user provided token
[2]: interactive token creation
Select option: 1
You can generate a new token by visiting https://github.com/settings/tokens.
Choose 'Generate new token' and set the necessary access scope for your repository.
The access scope depend on the type of repository.
Public:
	- 'public_repo': to be able to read public repositories
Private:
	- 'repo'       : to be able to read private repositories
Enter token: 87cf5c03b64029f18ea5f9ca5679daa08ccbd700
Successfully configured bridge: default
# For GitHub
git bug bridge new \
    --name=default \
    --target=github \
    --owner=example-owner
    --project=example-repo \
    --token=$TOKEN
# For Launchpad
git bug bridge new \
    --name=default \
    --target=launchpad-preview \
    --url=https://bugs.launchpad.net/ubuntu/
# For Gitlab
git bug bridge new \
    --name=default \
    --target=gitlab \
    --url=https://github.com/example-org/example-repo \
    --token=$TOKEN
```

## SEE ALSO

**[git-bug-bridge(1)](/git-bug-bridge/1.md)**