MultiConnectMultiConnectDocs Website home
MultiConnectCloud › API Deployments

4. Package your build

The rules for every platform

Before deploying, MultiConnectCloud checks that the zip contains the file it is told to run. For .NET it looks for the DLL; for Node.js it looks for the file after node in the start command, or the Entry Point File. If the file is missing, the deploy is refused with a message naming it.

What each platform runs

If you leave Start Command empty, the platform runs its default. The Start Command field shows the same default for the platform you picked. {PORT} is replaced with the container's port.

Platform Entry Point File Default start What the image does for you
.NET 10 Required: your DLL, for example MyApi.dll dotnet MyApi.dll Sets ASPNETCORE_ENVIRONMENT=Production
Node.js 22 Empty for index.js, or your main file node index.js Installs your production dependencies with npm ci. Sets NODE_ENV=production
Python Flask Empty for app.py, or your file gunicorn --bind 0.0.0.0:{PORT} --workers 2 app:app Installs requirements.txt, then gunicorn
Python FastAPI Empty for main.py, or your file uvicorn main:app --host 0.0.0.0 --port {PORT} --workers 2 Installs requirements.txt, then uvicorn[standard]
Python Django Not used by the default start gunicorn --bind 0.0.0.0:{PORT} --workers 2 config.wsgi:application Installs requirements.txt, then gunicorn. Sets DJANGO_SETTINGS_MODULE=config.settings.production. Runs collectstatic
Go Not used ./app Builds your source with go build, then runs the binary
Java Spring Boot Not used java -jar app.jar --server.port={PORT} Runs the one .jar in your zip. Sets container-aware memory settings in JAVA_TOOL_OPTIONS, which also apply to a custom start command

For Flask and FastAPI, the module name comes from the Entry Point File: server.py gives server:app. Your app object must be called app.

.NET

The zip is the output of dotnet publish. Set Entry Point File to the DLL it produced, named after your project. It is required: the form does not continue without it, unless your Start Command names the DLL itself (dotnet MyApi.dll).

Script 4.1: Publish and zip a .NET API (bash)

dotnet publish -c Release -o ./publish
cd publish && zip -r ../build.zip .

Script 4.2: Publish and zip a .NET API (PowerShell)

dotnet publish -c Release -o ./publish
Compress-Archive -Path ./publish/* -DestinationPath build.zip

Script 4.3: Zip layout for .NET

build.zip
├── MyApi.dll                  <- Entry Point File
├── MyApi.deps.json
├── MyApi.runtimeconfig.json
└── appsettings.json

A custom start command for .NET must begin with dotnet and name a .dll. If you write dotnet MyApi, it is corrected to dotnet MyApi.dll for you.

Node.js

Put package.json and package-lock.json at the top of the zip, and leave node_modules out. Dependencies are installed with npm ci when the image is built, which needs package-lock.json; a node_modules folder in the zip would be copied over that install. Only production dependencies are installed, so if you use TypeScript or a bundler, build first and zip the output.

Script 4.4: Zip a Node.js API

zip -r build.zip . -x "node_modules/*" -x ".git/*" -x "*.log"

Script 4.5: Zip layout for Node.js

build.zip
├── package.json
├── package-lock.json
└── server.js                  <- Start Command: node server.js

A custom start command for Node.js must start with node, npm, npx, yarn or pnpm. For example node server.js or npm start.

Python Flask

Put requirements.txt at the top of the zip. The build fails without it. You do not need to list gunicorn; it is installed for you.

Script 4.6: Zip layout for Flask

build.zip
├── requirements.txt           <- for example: flask
└── app.py                     <- Entry Point File (defines app = Flask(__name__))

Script 4.7: A minimal Flask app (app.py)

from flask import Flask

app = Flask(__name__)

@app.get("/health")
def health():
    return "ok"

@app.get("/")
def index():
    return {"hello": "world"}

Python FastAPI

Put requirements.txt at the top of the zip. Uvicorn is installed for you.

Script 4.8: Zip layout for FastAPI

build.zip
├── requirements.txt           <- for example: fastapi
└── main.py                    <- Entry Point File (defines app = FastAPI())

Script 4.9: A minimal FastAPI app (main.py)

from fastapi import FastAPI

app = FastAPI()

@app.get("/health")
def health():
    return "ok"

@app.get("/")
def index():
    return {"hello": "world"}

Python Django

The default start expects your Django project package to be called config, with production settings in config/settings/production.py. Put manage.py and requirements.txt at the top of the zip.

Script 4.10: Zip layout for Django

build.zip
├── requirements.txt           <- for example: django
├── manage.py
└── config/
    ├── __init__.py
    ├── wsgi.py
    ├── urls.py                <- include a /health route
    └── settings/
        ├── __init__.py
        └── production.py

If your project is laid out differently, set Start Command to your own gunicorn command.

A custom start command for Python

A custom Python start command must start with python, python3, gunicorn or uvicorn. For gunicorn or uvicorn, write {PORT} where the port goes, for example gunicorn --bind 0.0.0.0:{PORT} mysite.wsgi:application. To run python app.py, read the port from PORT in your code, as in Script 4.11.

Script 4.11: Read PORT when starting your own server (app.py)

import os
from flask import Flask

app = Flask(__name__)

@app.get("/health")
def health():
    return "ok"

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=int(os.environ["PORT"]))

Go and Java

Platform Zip contents
Go Your source, with go.mod at the top (go.sum if you have one). The package at the top of the zip is built, with CGO off
Java Spring Boot Exactly one executable .jar at the top of the zip. It must answer GET /health, like every platform. Spring Boot Actuator serves /actuator/health by default: map it to /health as in Script 4.12, or add your own /health endpoint

Script 4.12: Serve the Actuator health check at /health (application.properties)

management.endpoints.web.base-path=/
management.endpoints.web.path-mapping.health=health