FAQ

Frequently Asked Questions#

Do I need to know Docker?#

No. Runix generates optimized Dockerfiles automatically using AI. You just push your code and Runix handles the rest. If you do know Docker, you can provide your own Dockerfile in the repo root and Runix will use it instead.

What languages are supported?#

Runix supports the most popular languages and frameworks out of the box:

• Node.js — Express, Next.js, Fastify, Remix, Astro, and more
• Python — Django, Flask, FastAPI
• Go — Gin, Echo, Fiber, standard library
• Rust — Axum, Actix, Rocket
• Java — Spring Boot, Quarkus
• Static sites — HTML/CSS/JS, Vite, Create React App

Can I use a custom Dockerfile?#

Yes. Place a Dockerfile in your repository root and Runix will use it instead of generating one. Make sure your app listens on the PORT environment variable.

How do I connect to my database?#

When you deploy a database (PostgreSQL, Redis, or Kafka), Runix provides the connection details in the dashboard under your deployment's "Connection" tab. You can also fetch them via the API or CLI. The recommended approach is to copy the connection string into your app's environment variables.

# Set the connection string as an env var on your web service
runix env set my-api DATABASE_URL="postgresql://user:pass@host:5432/db"

Is there a free plan?#

Yes. The Hobby plan is completely free, forever. No credit card required. You get 1 service, 500 build minutes per month, and a runixcloud.dev subdomain. It is perfect for side projects and learning.

Can I deploy from a monorepo?#

Currently, each deployment maps to one repository. Monorepo support (deploying specific directories within a repo) is on our roadmap. In the meantime, you can use a custom Dockerfile that copies and builds from a specific directory.

How do I see my build logs?#

There are two ways to view build logs:

• Dashboard: Click your deployment, then go to the "Build Logs" tab
• CLI: Run runix logs my-service --build

Build logs show the full Docker build output in real time, including the AI-generated Dockerfile.

Can I SSH into my container?#

No. Containers are ephemeral and designed to be disposable. They are destroyed and recreated on every deploy. For debugging, use runtime logs:

runix logs my-service

How do backups work?#

On the Business plan, Runix automatically backs up your databases daily. Backups are stored for 30 days. You can restore from a backup through the dashboard or by contacting support. Manual snapshots are also available on all paid plans.

What happens if my app crashes?#

Runix automatically detects crashed containers and restarts them. If a container crashes repeatedly (more than 5 times in 10 minutes), Runix marks the deployment as "failed" and stops retrying. Check the runtime logs to find and fix the issue, then redeploy.

What uptime can I expect?#

Runix targets 99.9% uptime for all services. Business plan customers get an SLA guarantee with credits for any downtime. We run on Hetzner infrastructure with redundant systems.

Can I integrate Runix with my CI/CD pipeline?#

Yes. Use the CLI token in your CI/CD pipeline to trigger deploys programmatically. The push-to-deploy webhook handles the most common case (deploy on push to main), but you can also call the API directly for more control.

# GitHub Actions example
- name: Deploy to Runix
  run: |
    curl -X POST https://api.runix.dev/deployments/${{ secrets.DEPLOYMENT_ID }}/redeploy \
      -H "Authorization: Bearer ${{ secrets.RUNIX_TOKEN }}"