# gopkg charm

> This is the documentation for gopkg-k8s, a Kubernetes charm that deploys and operates the gopkg.in versioned import-path service with a 12-factor workflow.


2026

## Pages in this subsection

- [How-to guides](https://canonical.com/juju/docs/gopkg-charm/latest/how-to/index.html.md): Configure, observe, upgrade, and troubleshoot gopkg-k8s with task-focused procedures.
- [How to configure ingress](https://canonical.com/juju/docs/gopkg-charm/latest/how-to/configure-ingress/index.html.md): Route external HTTP traffic to gopkg-k8s with the NGINX ingress integrator, match the workload hostname, add DNS, and enable HTTPS.
- [How to configure hostname](https://canonical.com/juju/docs/gopkg-charm/latest/how-to/configure-hostname-and-check-go-import/index.html.md): Set the ingress and workload hostname of gopkg-k8s, then verify the go-import metadata served to Go clients.
- [How to integrate with COS Lite](https://canonical.com/juju/docs/gopkg-charm/latest/how-to/integrate-with-cos/index.html.md): Connect gopkg-k8s to COS Lite (Prometheus, Loki, and Grafana), verify that its metrics are scraped, and keep the metrics endpoint off the public hostname.
- [How to upgrade](https://canonical.com/juju/docs/gopkg-charm/latest/how-to/upgrade-the-charm/index.html.md): Move a gopkg-k8s deployment to a newer charm revision with juju refresh, wait for Juju to replace the workload, and verify the service through ingress.
- [How to troubleshoot deployment issues](https://canonical.com/juju/docs/gopkg-charm/latest/how-to/troubleshoot-deployment/index.html.md): Diagnose and fix common MicroK8s, Juju, ingress, HTTPS, and observability failures of a gopkg-k8s deployment.

## Optional

- [Top-level llms.txt](https://canonical.com/juju/docs/gopkg-charm/latest/llms.txt): Complete documentation index.