Skip to main content

Getting Started

This guide shows you how to set up your first project and deploy an application on Hostim.dev.

Projects in Hostim act as workspace for your apps, databases, and settings. You need at least one project before you can deploy anything.

The steps below use the web console. Everything here can also be done from a terminal, a CI job or an AI coding agent with the CLI — see From the command line at the end of this page.

Step 1: Sign in​

Create an account or log in at hostim.dev

Once logged in, you will be redirected to the dashboard.

Step 2: Create a project​

  1. In the dashboard, go to the Projects section.
  2. Click New Project.
  3. Give your project a descriptive name.
  4. Select a region for your project.
  5. Choose how to initialize the project:
    • Start from Scratch – create an empty project with just the name and region.
    • Use a Template – pick a preconfigured stack of apps, databases and volumes from our template library.
    • Docker Compose – paste a docker-compose.yml file to convert it into a template.
  6. Click OK.

You can now add apps, databases, and volumes to this project.

Step 3: Deploy your first app​

You can deploy from either a Docker image or a Git repository. Choose one:

Each app will run inside your project and can access project-specific resources like databases or volumes.

Step 4: Monitor and manage​

Once your app is running, you can:

  • View logs and metrics in real time
  • Scale CPU and memory
  • Connect to databases and mount storage

For more information, see the Apps section.

From the command line​

The console is not the only way in. The hostim CLI does everything this guide does, without a browser, which is what you want in CI or when an AI coding agent deploys for you:

curl -fsSL https://raw.githubusercontent.com/hostimdev/cli/main/install.sh | sh
hostim login                       # prints a code, waits for you to approve it
hostim projects create my-project --region eu-center
hostim use my-project
hostim deploy web --docker-image nginx:alpine --plan sa-1-1 --port 80
hostim status

hostim agent prints the complete manual — every command, flag and example — to stdout, which is the fastest way to give an agent the exact syntax. The manual is also on the web at hostim.dev/cli-manual.md.

Full CLI page: Command-line interface.

Next steps​