# 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 - [gopkg charm](https://canonical.com/juju/docs/gopkg-charm/latest/index.html.md): Operate the gopkg.in versioned Go import service on Kubernetes with the gopkg-k8s Juju charm. - [Tutorial](https://canonical.com/juju/docs/gopkg-charm/latest/tutorials/index.html.md): Follow an end-to-end tutorial to deploy the published gopkg-k8s charm on Kubernetes, verify it, and fetch a module through it with the Go tool. - [Deploy and verify gopkg-k8s on Kubernetes](https://canonical.com/juju/docs/gopkg-charm/latest/tutorials/deploy-and-verify-on-kubernetes/index.html.md): Deploy the published gopkg-k8s charm on Kubernetes with Juju, publish the service under a hostname, verify its go-import metadata, and fetch a module through it with the Go tool. - [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. - [Reference](https://canonical.com/juju/docs/gopkg-charm/latest/reference/index.html.md): Find gopkg-k8s configuration options, integration endpoints, supported platforms, and prerequisites. - [Charm configuration](https://canonical.com/juju/docs/gopkg-charm/latest/reference/charm-configuration/index.html.md): Reference the gopkg-k8s hostname option, its default value, and how it maps to the workload. - [Integrations](https://canonical.com/juju/docs/gopkg-charm/latest/reference/integrations/index.html.md): Reference the gopkg-k8s integration endpoints, the metrics, logs, dashboard, and alert rules the charm provides, and its observability options. - [Platforms and prerequisites](https://canonical.com/juju/docs/gopkg-charm/latest/reference/platforms-and-prerequisites/index.html.md): Reference the supported architectures, required tools and channels, MicroK8s add-ons, and verified tool versions for gopkg-k8s. - [Explanation](https://canonical.com/juju/docs/gopkg-charm/latest/explanation/index.html.md): Understand how gopkg.in resolves imports and how ingress exposes gopkg-k8s. - [How gopkg.in serves stable import paths](https://canonical.com/juju/docs/gopkg-charm/latest/explanation/gopkg-service/index.html.md): Understand what the gopkg.in service operated by gopkg-k8s does for Go programs, why its import paths still matter, and how the charm runs it. - [Ingress](https://canonical.com/juju/docs/gopkg-charm/latest/explanation/ingress/index.html.md): Understand how ingress routes external requests to gopkg-k8s on Kubernetes and how DNS, Services, and TLS fit together. - [Release notes](https://canonical.com/juju/docs/gopkg-charm/latest/release-notes/index.html.md): Review user-visible changes, compatibility notes, and operational updates for gopkg-k8s releases. - [gopkg-k8s release notes – latest/edge](https://canonical.com/juju/docs/gopkg-charm/latest/release-notes/release-notes-0002/index.html.md): Release notes for gopkg-k8s revisions 1-8: new features, bug fixes, and breaking changes. - [gopkg-k8s release notes - initial documentation baseline](https://canonical.com/juju/docs/gopkg-charm/latest/release-notes/release-notes-0001/index.html.md): Review the initial public-facing documentation baseline and validation updates for gopkg-k8s. - [Contribute](https://canonical.com/juju/docs/gopkg-charm/latest/contribute/index.html.md): Learn how to contribute to the documentation or code for gopkg-k8s. - [Set up a development environment](https://canonical.com/juju/docs/gopkg-charm/latest/contribute/set-up-a-development-environment/index.html.md): Prepare an Ubuntu environment with the tools required to build, test, and deploy gopkg-k8s from source. - [Improve the documentation](https://canonical.com/juju/docs/gopkg-charm/latest/contribute/improve-documentation/index.html.md): Build, preview, and validate gopkg-k8s documentation and executable examples locally. - [Improve the code](https://canonical.com/juju/docs/gopkg-charm/latest/contribute/improve-code/index.html.md): Set up and run Go, charm, and Juju integration tests for code changes to gopkg-k8s. - [How to run the full Juju integration suite locally](https://canonical.com/juju/docs/gopkg-charm/latest/contribute/run-full-juju-integration-suite-locally/index.html.md): Run the gopkg-k8s Juju integration suite locally with tox, in a Multipass VM prepared with charm-ci's tools. - [CI workflows](https://canonical.com/juju/docs/gopkg-charm/latest/contribute/ci-workflows/index.html.md): Reference the GitHub Actions workflows that test and publish the gopkg-k8s charm and that build, check, and execute its documentation. - [Troubleshoot the development environment](https://canonical.com/juju/docs/gopkg-charm/latest/contribute/troubleshoot-development/index.html.md): Diagnose and fix common registry, rock build, and tox failures when building gopkg-k8s from source.