Skip to main content

Creating a Project

A project in Hostim.dev is a workspace that contains your apps, services, and configuration. All apps must belong to a project.

You can use projects to organize environments like production, staging, or personal experiments.

Why projects matter​

Projects let you:

  • Group related apps together
  • Share environment variables and volumes between apps
  • Connect services like databases or Redis instances
  • Keep billing separate across environments

How to create a project​

  1. Go to your Hostim.dev dashboard
  2. Click Projects in the main menu.
  3. Click New Project.
  4. Enter a project name and select a region.
  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. Templates offer Dev, Prod, and Full profiles.
    • Docker Compose – paste a docker-compose.yml file to convert it into a template.
  6. Click Create Project.

See Project Templates for details on using templates or importing a compose file.

If you create a project before adding a payment method, it starts as a five-day trial. The trial project will be removed automatically unless you add billing information before it expires. Each account can only have one trial project at a time.

You'll be redirected to the project overview page, where you can add apps and services.

Managing a project​

From the project page, you can:

  • Add or remove apps
  • Create databases, Redis instances, or volumes
  • Set shared environment variables

You can create as many projects as you need.