Getting Started with norsulabs

Getting Started with norsulabs

Deploy your applications on norsulabs in minutes using three different methods: GitHub integration, Docker Images, or Hugging Face models.

Quick Start Guide

There are three ways to deploy on norsulabs: via GitHub, Docker Images, or Hugging Face.

1. Choose a Name

This name will become the subdomain where your app is hosted. For example, if you name your app my-app, it will be accessible at https://my-app.norsulabs.dev.

2. Select the App Type

You can choose between Web Applications and ML Models. While ML Models are currently in limited support, we are actively working to enhance this experience.

3. Select the Source

Choose from GitHub, Docker Images, or Hugging Face. Docker Images can be hosted on any registry—simply provide the full registry path, image name, and tag. For GitHub and Hugging Face, enter the repository URL.

4. Choose Your Builder (for GitHub Deployments)

If you selected GitHub, you can choose from three builders: Nixpacks, Dockerfile, or Static. We recommend using Dockerfile for the smoothest configuration. For static sites, the Static builder is fastest. Nixpacks may work well depending on your framework.

5. Specify a Port (Highly Recommended)

Although we make some assumptions about ports, we strongly recommend specifying the port your application runs on.

6. Select Compute Type

Compute tiers are available based on current capacity. The two main options are:

1. Basic – Serverless: 0.25 vCPUs, 512MB RAM
2. Standard – Dedicated: 0.25 vCPU, 512MB RAM

More options will be added soon.

7. Review and Deploy

After completing all required fields, review your settings and click the Deploy button to start the deployment process.

Deployment typically takes 1–5 minutes, depending on your configuration. Once complete, you’ll receive a URL where your application is hosted.

Need help? Contact us at [email protected] or visit your dashboard.