Skip to content

Getting Started

Nebion automates deployment of your web applications. Push code to your Git repository and Nebion creates isolated environments for each pull request.

Automatic PR Deploys

Push code, get a live environment for every pull request

Docker-Based

Your services run in isolated containers on your server

Config as Code

Define your setup in .nebion.yml alongside your code

CLI Access

SSH, logs, and diagnostics from your terminal

Prerequisites

  • Nebion access - platform URL and login credentials
  • Git repository on Bitbucket, GitHub, GitLab, or Gitea with admin access
  • Repository config files - .nebion.yml and docker-compose-nebion.yml in your repository

Core Concepts

ConceptWhat it is
OrganizationGroups your projects. You can belong to multiple organizations.
ProjectLinks a Git repository to a deployment server.
EnvironmentA running instance of your code (e.g., pr-42, staging).
WebhookAutomatic notification from Git to Nebion when code changes.

Setup in 5 Steps

  1. Prepare your repository

    Add two files to the root of your repository: .nebion.yml (deployment configuration — reference) and docker-compose-nebion.yml (your service definitions).

  2. Log in to Nebion

    Open your Nebion platform URL and log in with your credentials.

  3. Create a project

    Click New project and fill in your project name, repository URL, and organization. See Projects for details.

  4. Set up your webhook

    Add the deploy key and webhook URL to your Git repository. Follow the guide for your provider: Bitbucket, GitHub, GitLab, or Gitea.

  5. Create a test pull request

    Open a pull request in your repository. Nebion automatically creates an environment and deploys your code. Check the project page in Nebion to see your new environment.

Validate Before Deploying

Run nebioncli doctor from your project root to check your .nebion.yml and Docker Compose configuration for errors before pushing.

Next Steps