porter/README.md

Porter

Porter is a Kubernetes-powered PaaS that runs in your own cloud provider. Porter brings the Heroku experience to Kubernetes without compromising its flexibility. Get started on Porter without the overhead of DevOps and fully customize your infra later when you need to.

Why Porter?

A PaaS that grows with your applications

A traditional PaaS like Heroku is great for minimizing unnecessary DevOps work but doesn't offer enough flexibility as your applications grow. Custom network rules, resource constraints, and cost are common reasons developers move their applications off Heroku beyond a certain scale.

Porter brings the simplicity of a traditional PaaS to your own cloud provider while preserving the configurability of Kubernetes. Porter is built on top of a popular Kubernetes package manager called Helm and is compatible with standard Kubernetes management tools like kubectl, preparing your infra for mature DevOps work from day one.

Features

Basics

• One-click provisioning of a Kubernetes cluster in your own cloud console

  • ✅ AWS
  • 🚧 GCP
  • 🚧 Digital Ocean
    

• Simple deploy of any public or private Docker image

• Heroku-like GUI to monitor application status, logs, and history

• Marketplace for one click add-ons (e.g. MongoDB, Redis, PostgreSQL)

• Application rollback to previously deployed versions

• Native CI/CD with buildpacks (Coming Soon)

DevOps Mode

For those who are familiar with Kubernetes and Helm:

• Connect to existing Kubernetes clusters that are not provisioned by Porter
• Visualize, deploy, and configure Helm charts via the GUI
• User-generated form overlays for managing values.yaml
• In-depth view of releases, including revision histories and component graphs
• Rollback/update of existing releases, including editing of raw values.yaml

CLI Installation

Mac

Run the following command to grab the latest binary:

{
name=$(curl -s https://api.github.com/repos/porter-dev/porter/releases/latest | grep "browser_download_url.*/porter_.*_Darwin_x86_64\.zip" | cut -d ":" -f 2,3 | tr -d \")
name=$(basename $name)
curl -L https://github.com/porter-dev/porter/releases/latest/download/$name --output $name
unzip -a $name
rm $name
}

Then move the file into your bin:

chmod +x ./porter
sudo mv ./porter /usr/local/bin/porter

For Linux and Windows installation, see our Docs.

Getting Started

1. Sign up and log into Porter Dashboard.

2. Create a Project and select a cloud provider you want to provision a Kubernetes cluster in.

3. Put in your credentials, then Porter will automatically provision a cluster and an image registry in your own cloud account.

4. Build and push your Docker image to the provisioned registry with the CLI.

5. From the Templates tab on the Dashboard, select the Docker template. Click on the image you have just pushed, configure the port, then hit deploy.

Want to Help?

We welcome all contributions. Submit an issue or a pull request to help us improve Porter!