Skip to content

GokkuLightweight Git-Push Deployment

Deploy Go, Python, and Node.js applications with zero hassle. Like Dokku, but focused on simplicity.

Quick Start

Install Gokku on your server:

bash
curl -fsSL https://gokku-vm.com/install | bash -s -- --server

Install Gokku on your client:

bash
curl -fsSL https://gokku-vm.com/install | bash -s -- --client

Check version

bash
gokku version

Create a minimal gokku.yml:

yaml
project:
  name: my-app

apps:
  - name: api
    build:
      path: ./cmd/api
      binary_name: api
    ports:
      - 80:3000

Deploy your app:

bash
git remote add production user@server:api 

git push production main

That's it! Your app is live. 🎉

Why Gokku?

Gokku = Go + Dokku. A lightweight deployment system that:

  • ✅ Works great with Go applications (but supports Python, Node.js too)
  • ✅ Simple git-push workflow like Heroku/Dokku
  • ✅ No Docker dependency (but Docker is supported)
  • ✅ Per-app configuration and environments
  • ✅ Open source and hackable

Perfect for:

  • Side projects and startups
  • Internal tools
  • Microservices
  • Development/staging environments
  • Learning deployment workflows

What's Different?

FeatureHerokuDokkuGokku
Cost💰 Paid✅ Free✅ Free
Docker Native✅ Yes✅ Yes✅ Yes
Go-First❌ No❌ No✅ Yes
Config File❌ No❌ No✅ Yes
Zero-Downtime⚠️ Paid⚠️ Complex✅ Built-in

Community

Released under the MIT License.