Examples

Real-world examples of Gokku deployments for different use cases.

Quick Navigation

• Go Application - Deploy a Go REST API
• Python Application - Deploy a Python Flask app
• Rails Application - Deploy Ruby on Rails
• React Application - Deploy React with Node.js API
• Docker Application - Use Docker for deployment
• Multi-App Project - Deploy multiple apps from one repo

Example Projects

Go REST API

Simple Go API with Docker deployment:

apps:
  app-name: api
    path: ./cmd/api
      binary_name: api

View full example →

Python Flask App

Python web app with Docker:

apps:
  app-name: flask-app
    lang: python
    path: ./app
      entrypoint: app.py

View full example →

Docker Deployment

Using custom Dockerfile:

apps:
  app-name: service
    lang: python
    path: ./services/ml
      dockerfile: ./services/ml/Dockerfile

View full example →

Ruby on Rails

Full-stack Rails app with Docker deployment:

apps:
  app-name: rails-app
    lang: ruby
    path: .

View full example →

React with Node.js API

React frontend with Express API backend:

apps:
  app-name: react-app
    lang: nodejs
    path: .

View full example →

Monorepo with Multiple Apps

Deploy multiple services from one repository:

apps:
  app-name: api
    path: ./cmd/api
  
  app-name: worker
    path: ./cmd/worker
  
  app-name: ml-service
    lang: python
    path: ./services/ml

View full example →

By Use Case

Microservices

Deploy multiple independent services:

• Multi-App Project

With Database

Connect to PostgreSQL/MySQL:

• Go Application

With Cache

Use Redis for caching:

• Go Application

Background Jobs

Deploy workers and cron jobs:

• Multi-App Project

Machine Learning

Deploy ML services with dependencies:

• Python Application

Real-time

WebSocket and real-time apps:

• Go Application

By Technology

Languages

• Go: Go Application
• Python: Python Application
• Ruby: Rails Application
• Node.js: React Application

Frameworks

• Gin/Echo: Go Application
• Flask/FastAPI: Python Application
• Rails: Rails Application
• React + Express: React Application

Deployment

• Docker: All applications use Docker
• Zero-Downtime: Blue-Green Deployment

Community Examples

Share your examples! Submit a PR:

github.com/thadeu/gokku/tree/main/examples

Need Help?

• GitHub Discussions
• GitHub Issues