Get Started with Coderun

Welcome to Coderun, the first container-native Cloud that helps you simplify the deployment of any containerized application. In this guide, you’ll learn everything you need to get started.

🚀 Deploy your first app from GitHub

GitHub Integration

Go here and create your personal access token by assigning the repo and admin:repo_hook permissions:

GitHub Classic Token Permissions

Once you have your token, go to Coderun and configure it in the integrations section:

Coderun GitHub Token Permissions

Create your first Deployment

As an example, we’re going to deploy this application called Yopass that allows us to share secrets securely. For this, we’ll first deploy its database with memcached by clicking the “New Deployment” button at the top right and selecting “Docker Image”:

New Deployment Deploy

In the form, fill in the following fields:

  • Docker Image: memcached
  • App Name: yopass-memcached
  • Port: 11211
  • Protocol: TCP

Leave the rest of the fields with their default values:

Deploy Memcached for Yopass

Click Next. In the environment variables section, you can click Next directly and finally Deploy. After a few seconds, you’ll have your memcached deployed with its connection string ready to use:

Yopass Memcached Deployment

Create your first Deployment from GitHub

Once we have the dependency, I’ve made sure to include the connection string in the Dockerfile we’re going to use to launch the app: Dockerfile.coderun. So now let’s deploy the app from GitHub. Click New Deployment again and this time select GitHub Repository.

In the form that opens, fill in the following fields in the Build tab:

  • Docker path: Dockerfile.coderun
  • App Name: yopass
  • Branch: master
  • Repository URL: https://github.com/helmcode/yopass.git

Click Next and in the Deploy tab fill in:

  • Port: 3003
  • Protocol: HTTP

After this, click Next, in the environment variables section you can click Next directly again and finally Deploy:

Deploy Yopass Application

💡 Keep in mind that this process can take several minutes as Coderun will fetch your Dockerfile and use it to automatically build and deploy your application.

And that’s it! With this, you’ll have your application deployed. You can try it yourself through this link:

Yopass Application Dashboard

Do you need help?

If you have questions or run into issues, we're here to help you.