Deploying Your First App

Supported Runtimes

Select your runtime when creating a service. HostStack auto-detects build tools where possible. You can also bring your own Dockerfile for any language.

Build & Start Commands

Configure your install, build, and start commands in service settings. Here are common examples:

Build Command:  npm run build
Start Command:  npm start

Build Command:  pip install -r requirements.txt
Start Command:  gunicorn app:app --bind 0.0.0.0:$PORT

Build Command:  go build -o server .
Start Command:  ./server

Build Command:  bundle install
Start Command:  bundle exec rails server -p $PORT

Build Command:  mix deps.get && mix release
Start Command:  _build/prod/rel/my_app/bin/my_app start

Build Command:  dotnet publish -c Release -o out
Start Command:  dotnet out/MyApp.dll

Build Command:  composer install --no-dev
Start Command:  php -S 0.0.0.0:$PORT -t public

Build Command:  ./mvnw -q -DskipTests package
Start Command:  java -jar target/my-app.jar --server.port=$PORT

Docker Deploys

If your language isn't natively supported or you need custom system dependencies, add a Dockerfile to your repo and select the Docker runtime. HostStack will build your image and deploy the resulting container.

FROM node:20-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY . .
EXPOSE $PORT
CMD ["node", "server.js"]

Zero-Downtime Deploys

HostStack uses zero-downtime rolling deploys. When you deploy, a new container starts alongside the current one. Once the new container passes health checks, traffic switches over. The old container is gracefully stopped. Your users never see downtime.

Environment Variables

Set environment variables in the Settings tab. They're encrypted at rest and available during build and runtime. See the Environment Variables guide for details.

Health Checks

HostStack checks your service is healthy before routing traffic. Set a health check path (e.g., /health) in your service settings. The endpoint should return HTTP 200 when your app is ready.

healthcheck:
  path: /health
  interval: 10s
  timeout: 5s
  retries: 3

If no health check path is set, HostStack will check that your container starts and listens on the configured port.

Build Cache

HostStack caches your build dependencies between deploys. For Node.js, this means node_modules is cached. For Python, pip packages are cached. This significantly speeds up subsequent builds. Cache is cleared when your lock file changes.

Database Migrations

Run your migrations as part of the service start command (e.g., npm run migrate && node server.js). They execute inside the new container before traffic switches, so a broken migration fails the deploy and the previous version keeps serving.

Each successful application emits a migration.applied activity-log event (visible in the dashboard activity feed and via the MCP list_activity_log tool), so you can tell a "no-op redeploy" apart from a "ran a fresh migration" without grepping deploy logs.

// At the end of your data-seed migration:
import { redis } from './redis';
await redis.del(...(await redis.keys('seo:*')));

Troubleshooting