<!-- llms-txt: https://hydron.app/llms.txt -->
<!-- llms-full-txt: https://hydron.app/llms-full.txt -->
<!-- canonical: https://hydron.app/docs/quick-start -->

# 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](https://hydron.space/register) 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](/images/docs/projects-dashboard.png)

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](/images/docs/deploy-source-selection.png)

- **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](/images/docs/chat-interface.png)

## 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](/images/docs/chat-calcom.png)

## 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](/images/docs/chat-hydron.png)

## 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:

- [Key Concepts](/docs/concepts) — Understand projects, services, and plans in depth
- [Environment Variables](/docs/environment-variables) — Configure secrets and settings
- [Domains & SSL](/docs/domains-ssl) — Set up custom domains
- [Server Inventory](/docs/server-inventory) — Manage your servers
- [Deployment Runs](/docs/deployment-runs) — Monitor and troubleshoot deployments
