Skip to main content

Creating Serverless Apps

Deploy autoscaling applications without managing infrastructure. Targon Serverless scales your app from zero to peak traffic automatically, so you only pay for the compute you use.

Quick Start (Dashboard)​

The easiest way to launch an app is through the Targon Dashboard.

  1. Create App: Navigate to Serverless > New App.
  2. Select Hardware: Pick the CPU or GPU tier that fits your workload.
  3. Choose a Starting Point:
    • Public Templates: Ready-to-use apps pre-configured by Targon.
    • Custom: Deploy your own image.

Custom Configuration​

If you choose Custom, you will need to provide the Image, Port, and optional Command.

View configuration reference for details on arguments, environment variables, and auto-scaling.

  • Image: The Docker image URL (e.g., python:3.11 or ghcr.io/my-org/my-app).
  • Port: The internal port your app listens on (Targon routes public traffic here).
  • Command (Optional): The startup command (e.g., python main.py).

Infrastructure as Code (SDK)​

For production workflows, define your infrastructure in Python alongside your application code. This ensures your deployment is reproducible and version-controlled.

# targon-sdk/examples/getting_started/getting_started.py
import targon

# Define the environment
app = targon.App("getting-started", image=targon.Image.debian_slim("3.12"))

# Define the endpoint
@app.function()
def hello(message: str) -> dict[str, str]:
    return {"message": message, "status": "success"}

Deployment Workflow​

  1. Test Locally: targon run main.py
  2. Deploy to Cloud: targon deploy main.py
  3. Manage: targon app list

Next Steps​