---
title: Charmhub | Deploy Git-Ubuntu Package Importer Charm using Charmhub - The Open
  Operator Collection
description: Deploy the latest version of Git-Ubuntu Package Importer Charm on any
  cloud. A charm for deploying git-ubuntu for package importing.
url: https://charmhub.io/git-ubuntu
---

# Git-Ubuntu Package Importer Charm

[Lena Voytek](https://charmhub.io/publisher/lvoytek "View all packages from Lena Voytek")

* [Lena Voytek](https://charmhub.io/publisher/lvoytek "View all packages from Lena Voytek")

Platform:

24.04

stable 16

```
juju deploy git-ubuntu
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Relevant links

* [Homepage](https://charmhub.io/git-ubuntu)

---

#### Contacts

* [Submit a bug](https://github.com/canonical/git-ubuntu-operator/issues)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# Git-Ubuntu Operator

**Git-Ubuntu Operator** is a machine [charm](https://juju.is/charms-architecture)
that deploys [git-ubuntu](https://launchpad.net/git-ubuntu).

**Git-Ubuntu** is a tool that generates and updates git repositories associated with packages in Ubuntu, providing developers with a git-based package maintenance solution.

## [Architecture](https://charmhub.io/git-ubuntu#p-39733-architecture)

The Git-Ubuntu Operator maintains units with the following architecture:

## [Getting started](https://charmhub.io/git-ubuntu#p-39733-getting-started)

Deploy the git-ubuntu importer using `juju deploy git-ubuntu --num-units 2`.

You can additionally scale up the number of workers by increasing the number of units in `--num-units`. The leader unit will contain the poller and broker processes, and all others will contain only worker processes.

### [Secrets](https://charmhub.io/git-ubuntu#p-39733-secrets)

A Launchpad auth token and SSH private key can be provided together to git-ubuntu via the `lpuser_secret_id` config entry.

#### Launchpad Key

An API token is required to gather data from Launchpad. It is included with `juju add-secret lpuser-secret-id lpkey=/path/to/lpkey_file`. It is easiest to generate it using the `ppa-dev-tools` snap, which has an option to create the file directly:

```
snap install ppa-dev-tools
ppa credentials
```

This will generate a link to set up the key. Its contents will then be generated in the file `credentials.oauth`.

#### SSH Key

If the importer needs to be set up to publish to launchpad, an SSH secret key associated with `lpuser` is required. It can be included with `juju add-secret lpuser-secret-id sshkey=/path/to/ssh_key`

## [Contributing](https://charmhub.io/git-ubuntu#p-39733-contributing)

Please see the [Juju SDK docs](https://juju.is/docs/sdk) for guidelines on enhancements to this charm following best practice guidelines, and [CONTRIBUTING.md](https://github.com/canonical/git-ubuntu-operator/blob/main/CONTRIBUTING.md) for developer guidance.

## [License](https://charmhub.io/git-ubuntu#p-39733-license)

git-ubuntu-operator is free software, distributed under the Apache Software License, version 2.0. See [LICENSE](https://github.com/canonical/git-ubuntu-operator/blob/main/LICENSE) for more information.

---

[Help improve this document in the forum](https://discourse.charmhub.io/t/git-ubuntu-operator-documentation/19098) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated 10 months ago.