Appearance
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.ymlanddocker-compose-nebion.ymlin your repository
Core Concepts
| Concept | What it is |
|---|---|
| Organization | Groups your projects. You can belong to multiple organizations. |
| Project | Links a Git repository to a deployment server. |
| Environment | A running instance of your code (e.g., pr-42, staging). |
| Webhook | Automatic notification from Git to Nebion when code changes. |
Setup in 5 Steps
Prepare your repository
Add two files to the root of your repository:
.nebion.yml(deployment configuration — reference) anddocker-compose-nebion.yml(your service definitions).Log in to Nebion
Open your Nebion platform URL and log in with your credentials.
Create a project
Click New project and fill in your project name, repository URL, and organization. See Projects for details.
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.
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
- Project Configuration - set up
.nebion.yml - Environment Variables - configure custom variables
- CLI Tool - access environments from your terminal