Watch

Helm chart for installing GoToSocial on Kubernetes

gotosocial helm

Go Template 85.6%
Shell 14.4%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Owentje d49c512f88 All checks were successful Release Chart / build-and-push (push) Successful in 6s Details Release Chart / harbor (push) Successful in 0s Details Release Chart / build-and-push-1 (push) Successful in 6s Details Release Chart / forgejo (push) Successful in 0s Details Release Chart / build-and-push-2 (push) Successful in 6s Details Release Chart / codeberg (push) Successful in 0s Details Update to version 7.2.1 and regenerate docs.		2026-09-28 09:44:23 +00:00
.forgejo	update the renovate config migration	2026-09-06 12:23:53 +02:00
charts/gotosocial	Update to version 7.2.1 and regenerate docs.	2026-09-28 09:44:23 +00:00
scripts	fix renovate update script	2026-05-15 09:36:57 +02:00
.gitignore	Adds Linkwarden Chart	2025-02-11 15:15:27 +01:00
.pre-commit-config.yaml	initial commit to move this all to forgejo as ONLY the GoToSocial chart	2026-05-14 13:53:41 +02:00
AI_POLICY.md	fix repo location in the AI Policy	2026-09-05 16:33:14 +02:00
CODE_OF_CONDUCT.md	initial commit to move this all to forgejo as ONLY the GoToSocial chart	2026-05-14 13:53:41 +02:00
LICENSE	update licensing and links	2026-05-14 15:15:09 +02:00
README.md	use cnpg instead of bitnami postgresql, update how we get renovate updates, clean up workflows, simplify db env vars in templates, update readme	2026-09-06 12:02:54 +02:00
renovate.json	fix when we label a PR and remove github actions updates that we don't do	2026-09-06 12:27:01 +02:00

README.md

GoToSocial Helm Chart

Effortlessly deploy your own 🦥 GoToSocial, a fantastic federated micro-blogging platform, with Helm on Kubernetes!

We include an optional sub-chart to deploy a local Cloud Native PostgreSQL Cluster alongside your GoToSocial deployment. This requires you to have already installed the CNPG Operator.

We now also include phanpy as an optional frontend. We default deploy the our phanpy-docker image, but you can sub out anything you like!

Getting Started

Prerequisites

Ensure you have Helm installed. If not, check out Helm's documentation for installation instructions and an overview of how Helm works.

Adding the Repository

Once Helm is set up, add the repo you'd like to install from. We support only codeberg.org at this time, but check back later for more options!

codeberg.org (recommended)

helm repo add codeberg.org https://codeberg.org/api/packages/open-engineering/helm
helm repo update

Searching for Charts

Find available charts by searching the repository.

codeberg.org (recommended)

helm search repo codeberg.org

Installing a Chart

To install the chart, run one of the following

codeberg.org (recommended)

helm install gotosocial codeberg.org/gotosocial

Uninstalling a Chart

To uninstall a chart:

helm delete <chart-name>

🌟 Contributing

Your ideas, bug fixes, and enhancements are highly appreciated! Whether it's a bug report, feature request, or a pull request, your contributions make this repository better for everyone.

How to Contribute

Fork the repository on codeberg.org.
Make your changes.
Open a pull request on codeberg.org.

For any issues or questions, feel free to open a Codeberg issue. Let's build something great together! 💚

Credits

Tip

This repo was forked from github.com/0hlov3/charts whom we loved working with! We still love working with them, but would like to move off of GitHub and self host as much as possible. We've also gotten explicit permission to change the licensing from Apache 2.0 to AGPL to better match GoToSocial's upstream licensing and keep everything more truly FOSS.