A comprehensive collection of example applications demonstrating how to deploy various languages, frameworks, and popular applications on Convox. Each example includes production-ready convox.yml configurations, optimized Dockerfiles, and best practices for deployment.

These examples demonstrate the simplicity of deploying applications on Convox, whether you're using Convox Cloud for a fully-managed experience or your own Convox Rack for complete infrastructure control. Each example is:

• Production-Ready: Configured with health checks, scaling, and proper resource allocation
• Well-Documented: Includes detailed READMEs with deployment instructions
• Best Practices: Follows Docker and Convox best practices for optimal performance
• Framework-Specific: Tailored configurations for each language and framework
• Quick to Deploy: Get running in minutes with simple commands

# Clone an example
$ git clone https://github.com/convox-examples/nodejs.git
$ cd nodejs

# Deploy to Convox Cloud
$ convox cloud apps create myapp -i machine-name
$ convox cloud deploy -a myapp -i machine-name

# Clone an example
$ git clone https://github.com/convox-examples/rails.git
$ cd rails

# Deploy to your Rack
$ convox apps create myapp
$ convox deploy -a myapp

Each example repository follows a consistent structure:

example-app/
├── README.md           # Deployment instructions & documentation
├── convox.yml          # Convox application manifest
├── Dockerfile          # Optimized container configuration
├── docker-compose.yml  # Local development setup (optional)
├── .env.example        # Environment variables template
├── src/                # Application source code
└── test/               # Test files

environment:
  - NODE_ENV=production
  
resources:
  database:
    type: postgres
    options:
      storage: 10
      
services:
  web:
    build: .
    port: 3000
    health: /health
    scale:
      count: 1-10
      targets:
        cpu: 70
        memory: 90
    resources:
      - database
      
  worker:
    build: .
    command: npm run worker
    scale:
      count: 1-5
    resources:
      - database

• Get Started Free
• Convox Documentation
• CLI Installation
• Your First Deployment

• convox.yml Reference
• Environment Variables
• Scaling Applications
• Custom Domains
• SSL Certificates
• CI/CD Workflows

• Convox Academy Playlist
• Getting Started Video
• Deployment Tutorial
• CI/CD Setup

We welcome contributions! To add or improve an example:

1. Fork the repository you want to contribute to
2. Create a feature branch (git checkout -b add-new-example)
3. Make your changes following the existing patterns
4. Test your deployment on both Convox Cloud and Rack
5. Submit a Pull Request with a clear description

• Include a comprehensive README with deployment instructions
• Provide both development and production configurations
• Follow Docker best practices (multi-stage builds, small images)
• Include health checks and proper scaling configuration
• Add environment variable documentation
• Test on multiple cloud providers when possible

Can't find what you're looking for? Open an issue to request a new example. Please include:

• The technology/framework you'd like to see
• Your use case and requirements
• Any specific configuration challenges

Deploy a GPU-accelerated AI application:

# Clone the LLM API example
$ git clone https://github.com/convox-examples/llm-gpu-api.git
$ cd llm-gpu-api

# Review the GPU configuration
$ cat convox.yml

# Deploy with GPU support
$ convox deploy -a my-llm-api

This example demonstrates:

• GPU resource allocation
• Model serving at scale
• Optimized inference
• Auto-scaling based on load

Deploy a full-featured Rails application:

# Clone the Rails example
$ git clone https://github.com/convox-examples/rails.git
$ cd rails

# Deploy the complete stack
$ convox deploy -a my-rails-app

Features:

• Rails web application
• PostgreSQL database
• Redis for caching/ActionCable
• Sidekiq background jobs
• Asset pipeline optimization

Deploy your own workflow automation platform:

# Clone the n8n example
$ git clone https://github.com/convox-examples/n8n.git
$ cd n8n

# Deploy n8n
$ convox deploy -a my-n8n

Includes:

• PostgreSQL for persistent storage
• Webhook support with SSL
• User authentication
• 400+ service integrations

• Community Forum
• GitHub Discussions
• Stack Overflow

• Website
• Blog
• Twitter
• LinkedIn

• Documentation: docs.convox.com
• Enterprise: convox.com/enterprise
• Community: community.convox.com

All examples are provided under the Apache 2.0 License.

Deploy with confidence using Convox
The Platform-as-a-Service that puts you in control

Get Started Free • Documentation • Main Repository