Skip to main content

Getting Started

This guide will walk you through the process of getting started with Thevenin, from creating your account to deploying your first containerized application.

Prerequisites​

Before you begin, make sure you have:

  • A Thevenin account - Sign up at the Thevenin platform
  • MFA enabled in your Thevenin account
  • A container image ready to deploy (e.g. nginx:latest, postgres:14)
  • Basic knowledge of containerization and Docker concepts

Step 1: Create Your Account​

  1. Navigate to the Thevenin sign-up page
  2. Complete the registration process
  3. Verify your email address
  4. Log in to your Thevenin dashboard

Step 2: Create Your First Environment​

Important: Environments must be created before deploying applications. An environment is where your applications will run.

Beta Resource Allocation

During the BETA phase, new accounts receive a default resource reservation:

  • 1 Environment
  • CPU: 1 core (1000m)
  • Memory: 512 MB
  • Filesystem Storage: 5 GB
  • Persistent Volumes: 10 GB
  • Bandwidth In: 10 MBps
  • Bandwidth Out: 1 MBps

You can allocate these resources across your environment(s) as needed.

  1. Navigate to Environments

    • Click on "Environments" in the main navigation

  2. Create New Environment

    • Click the "New Environment" button
    • Fill in the environment details:
      • Name: Choose a descriptive name (e.g., "Development", "Production")
      • Description: Add a brief description

  3. Configure Environment Resources

    • Allocate resources from your available reservation:
      • CPU: Specify in millicores (m) or cores (e.g., 500m or 0.5 cores)
      • Memory: Set memory limits (e.g., 256MB, 512MB)
      • Storage: Define storage capacity (e.g., 5GB)

  4. Save Your Environment

    • Click "Create Environment" to save your configuration

Step 3: Deploy Your First Application​

Once you have an environment, you can deploy applications to it:

  1. Navigate to Your Environment

    • Go to the environment you just created

  2. Add New Application

    • Click "Deploy Application" or "New Application"
    • Fill in the application details:
      • Name: Choose a descriptive name for your application
      • Description: Add a brief description (optional)

  3. Configure Container Settings

    • Container Image: Specify a container image
      • Format: image:tag (e.g., nginx:latest, postgres:14, redis:alpine)
    • Port Mapping: Configure which ports your application exposes

  4. Save Your Application

    • Click "Deploy Application" to start deployment

Step 4: Configure Application Resources (Optional)​

Environment Variables​

Set up environment variables for your application:

  1. Navigate to Variable Sets
  2. Click "Create Variable Set"
  3. Add your environment variables:
    • Name: DATABASE_URL
    • Value: postgresql://...
  4. Save the variable set
  5. Attach it to your application

Volumes (Optional)​

If your application needs persistent storage:

  1. Navigate to Volumes
  2. Click "Create Volume"
  3. Configure volume settings:
    • Name: Volume identifier
    • Size: Storage capacity
    • Mount Path: Where to mount in the container
  4. Attach the volume to your application

Step 5: Monitor Your Application​

Once deployed, you can monitor your application:

  1. View Application Details

    • Click on your running application
    • Check the application status

  2. View Logs

    • Access real-time application logs
    • Monitor for any issues

  3. Check Resources

    • Monitor CPU and memory allocation

Quick Start Example​

Here's a complete example deploying an NGINX web server:

Step 1 - Create Environment:
  Name: Production
  CPU: 2 cores
  Memory: 4 GB
  Storage: 20 GB

Step 2 - Deploy Application:
  Name: my-web-app
  Container Image: nginx:latest
  Port: 80
  Expose: true

Common Container Images​

Here are some popular images you can use:

Web Servers:

  • nginx:latest - NGINX web server
  • nginx:alpine - Lightweight NGINX

Databases:

  • postgres:14 - PostgreSQL database
  • mysql:8 - MySQL database
  • redis:alpine - Redis cache
  • mongo:latest - MongoDB

Applications:

  • node:18-alpine - Node.js runtime
  • python:3.11-slim - Python runtime

Next Steps​

Now that you've deployed your first application, explore more features:

Getting Help​

If you encounter any issues:

  • Check the application logs in your dashboard
  • Review this documentation
  • Contact support through the platform at support@thevenin.io

Welcome to Thevenin! 🚀