llms.txt

Quick Start

Deploy your first application with Hydron in just a few minutes. This guide walks you through the entire process from sign-up to a live deployment.

Prerequisites

Before you begin, you'll need:

  • A Hydron account — Sign up for free if you don't have one
  • A Git repository with your application code (GitHub, GitLab, Bitbucket, or any public URL)
  • Alternatively, a Docker image already pushed to a registry

Step 1: Create a project

After signing in, you'll land on the Projects dashboard. Click New Project to create your first project.

The Projects dashboard showing your projects organized in a card grid

Give your project a name and select a type that best matches your application (Web App, Microservice, Static Site, etc.). The project type helps Hydron optimize its analysis and deployment strategy.

Step 2: Start a chat

Once your project is created, you'll be taken to the chat interface. This is where you interact with the AI assistant to deploy your application.

You'll see a welcome screen with deployment options:

Select your deployment source — Git provider, public URL, Docker image, or templates
  • GitHub / GitLab / Bitbucket — Connect your account and select a repository
  • Public Git URL — Paste any public repository URL
  • Docker Image — Provide a Docker image name and tag
  • Templates — Choose from pre-built deployment templates

Step 3: Connect your code

For this quick start, let's deploy from a Git URL. Click on Public Git URL and paste your repository URL, then click Analyze Repository. The AI will begin scanning your codebase.

Step 4: Review the code analysis

Hydron's AI analyzes your repository to detect:

  • Frameworks and languages (e.g., Node.js with Express, Python with Django)
  • Services within your project (API server, frontend, database, etc.)
  • Dependencies and their versions
  • Environment variables your app needs
  • Existing Dockerfiles or recommendations for new ones

The analysis results appear in the chat and in the right sidebar panel. Review the detected services and make any adjustments if needed.

The chat shows AI analysis results with detected services in the right sidebar

Step 5: Generate an infrastructure plan

After the analysis, the AI generates an infrastructure plan tailored to your application. The plan includes:

  • Server specifications — CPU, RAM, storage, and datacenter location
  • Docker configuration — Dockerfiles for each service
  • Networking — Port mappings, domain configuration
  • Environment variables — Required variables with descriptions
  • Health checks — Endpoints and intervals for monitoring

Review the plan in the Infrastructure tab on the right sidebar. You can ask the AI to modify any aspect — change server size, add or remove services, adjust environment variables.

The Services and Plan panels in the right sidebar

Step 6: Approve and deploy

When you're satisfied with the plan, approve it. The AI will:

  1. Provision the server — Set up a dedicated server with your chosen specs
  2. Install Docker and required software
  3. Build your application using the configured Dockerfile
  4. Deploy containers with proper networking and health checks
  5. Configure domains and SSL — Set up your domain with automatic SSL certificates

You can watch the entire process in real-time through the Runs tab on the right sidebar. Each step shows live logs and progress indicators.

Deployment completion messages showing successful provisioning

Step 7: Your app is live

Once deployment completes, your application is live and accessible. You'll receive:

  • Your application URL with SSL configured
  • SSH access credentials for direct server access
  • Deployment logs for debugging if needed

What's next?

Now that your first app is deployed, explore these guides:

Hydron