Getting Started

Welcome to Burrito! This guide will walk you through creating your account, setting up your first site, and deploying your app.

Create an Account

  1. Go to console.bntso.com and click Register
  2. Enter a username, email address, and password
  3. You'll be logged in automatically and taken to the console

Create a Site

  1. From the console, click New Site
  2. Choose a name for your site (lowercase letters, numbers, and hyphens)
  3. Your site will be available at yoursite.bntso.com once deployed

Deploy by Uploading a File

The simplest way to deploy is to upload a zip or tar.gz of your project. Your archive must contain a Dockerfile in the root (see Dockerfile Requirements).

Upload via the web UI

  1. Go to your site's detail page on the console
  2. Select the environment (production or test)
  3. Choose your project archive and click Deploy

Upload via the API

# Zip your project (must include a Dockerfile)
zip -r myapp.zip . -x '.git/*'

# Upload and deploy
curl -X POST https://console.bntso.com/api/v1/sites/yoursite/deploy \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@myapp.zip" \
  -F "environment=prod"

Your API key is shown on your console after you log in. The deploy happens asynchronously — you'll get back a deployment ID to track progress.

Alternative: Deploy with git push

For a git-based workflow, add Burrito as a remote and push to deploy. This requires an SSH key.

Add your SSH key

  1. If you don't have an SSH key yet, generate one: 
    ssh-keygen -t ed25519 -C "your@email.com"
  2. Copy your public key: 
    cat ~/.ssh/id_ed25519.pub
  3. Add it via the API: 
    curl -X POST https://console.bntso.com/api/v1/ssh-keys \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"public_key": "ssh-ed25519 AAAA... your@email.com"}'

Push to deploy

cd your-project
git remote add burrito git@bntso.com:yoursite.git
git push burrito main

Pushing to main deploys to production. Pushing to test deploys to the test environment.

View Your Site

After a successful deploy, your site will be live at:

  • Production: https://yoursite.bntso.com
  • Test: https://test.yoursite.bntso.com

You can check deployment status and build logs from the site detail page on the console.

What's Next