Quick Start

This guide helps you create a project, choose a deployment source, deploy, then expose or access the service.

Before You Start

You need:

• A Hubfly space account
• A project in a region
• One of these deployment sources:
  • A GitHub repository
  • A Docker image
  • A template

Create A Project

1. Open the dashboard.
2. Create a new project.
3. Choose the region for the project.

Choose A Deployment Path

Hubfly space supports three single-container deployment paths.

Option 1: Deploy From GitHub

Use this when your app is hosted on GitHub and you want Hubfly Space to automatically detect your stack and build it. If a Dockerfile exists, Hubfly Space will detect and use it.

1. Open the project.
2. Go to New Container.
3. Choose Git Repository.
4. Select or paste the GitHub repository.
5. Pick a branch.
6. Optionally set a root directory.
7. Connect the repository.
8. Keep automatic build enabled or switch to manual build settings.
9. Continue through resources, storage, runtime, and review.
10. Deploy.

Option 2: Deploy From A Docker Image

Use this when you already have a published Docker image or want to deploy your favorite tool directly.

1. Open New Container.
2. Choose Docker Image.
3. Enter the image reference, for example nginx:latest or ghcr.io/org/app:tag.
4. Optionally override the entrypoint and command. Write one command per line.
5. Continue through resources, storage, runtime, and review.
6. Deploy.

Option 3: Deploy From A Template

Use this when you want a ready-made starting point.

1. Open New Container.
2. Choose Template.
3. Search the template marketplace.
4. Select a template.
5. Review the default ports, volumes, commands, and env vars.
6. Continue through the remaining steps and deploy.

After Deploy

Once the container is running, common next steps are:

• Add a public endpoint
• Attach a custom domain
• Open logs
• Add or adjust environment variables
• Create a HubTunnel for private access

What To Use Next

• Deploy From Git
• Deploy From Image
• Templates
• Compose Stacks
• Networking