Frequently Asked Questions

Find answers to common questions about deploying with Rock8Cloud.

Getting Started

What do I need to deploy on Rock8Cloud?

Just two things:

• A GitHub repository
• A Dockerfile with an exposed port

That's it — Rock8Cloud handles everything else.

Do I need to know Docker?

No. If you already have a Dockerfile, great — it'll work on Rock8Cloud as-is. If you don't, ask your AI coding agent to create one for you.

Example prompt for your agent:

Create a production-ready Dockerfile for my project.
It should build the app, expose the correct port, and
keep the image as small as possible.

Most agents (Cursor, Claude Code, GitHub Copilot) can generate a working Dockerfile from your project structure in seconds. See our Dockerfile Requirements guide for what Rock8Cloud expects.

What languages and frameworks are supported?

Any language that runs in Docker:

• Node.js, Python, Go, Ruby, PHP, Java, .NET
• React, Vue, Angular, Next.js, Nuxt
• Express, Flask, Django, Rails, Laravel
• And many more!

If it has a Dockerfile, we can deploy it.

How long does the first deployment take?

Usually 2-5 minutes, depending on:

• Image size
• Number of dependencies
• Build complexity

Subsequent deployments are faster thanks to build caching.

Deployments

How do deployments work?

1. Push code to GitHub
2. Rock8Cloud receives webhook notification
3. Builds Docker image
4. Pushes to registry
5. Deploys to your environment
6. Runs health checks

See How Rock8Cloud Works for details.

Can I deploy manually?

Yes! Click Redeploy service on your service page to deploy the latest code without pushing.

How do I rollback a deployment?

1. Go to your service's Deployments tab
2. Find the deployment to restore
3. Click Rollback

This redeploys the previous image instantly without rebuilding. See Rollback Deployments for more details including the difference between rollback and rebuild.

Can I cancel a deployment in progress?

Yes, click Cancel on the deployment page. The build/deploy process stops immediately and the previous version continues running.

Databases

What databases do you support?

Currently:

• PostgreSQL (versions 14-17)
• Dragonfly - Redis-compatible in-memory datastore

How do I connect to a database?

1. Add a database to your project
2. Link the exposed environment variables to your service in Configuration → Environment Variables
   • PostgreSQL exposes: HOST, PORT, NAME, USER, PASSWORD, URL
   • Dragonfly exposes: HOST, PORT

See Adding a Database for details.

Is my database data persistent?

Yes! Database data persists across:

• Container restarts
• Service redeployments
• Application updates

Data is stored on persistent volumes.

Can I access my database directly?

Databases are network-isolated for security. They're only accessible from services within the same project.

For direct access, you'll need to connect through a service in your project or contact support.

S3 Object Storage

Do you support object storage?

Yes! Rock8Cloud provides S3-compatible object storage. You can deploy an S3 storage service and use it with any S3-compatible client library.

See S3 Object Storage for setup instructions.

Environment Variables

How do I add environment variables?

1. Go to your service page
2. Go to Configuration → Environment Variables
3. Click Add Variable
4. Enter key and value
5. Click Save

Saving automatically redeploys your service with the new configuration.

Do preview deployments use different environment variables?

No, preview deployments use the same environment variables as production.

Be careful with preview deployments if your env vars point to production services. Consider using separate staging projects with staging databases and APIs for safe testing.

Domains & URLs

What domain do my apps use?

All services use the *.apps.rock8.cloud domain:

https://your-service-name.apps.rock8.cloud

Can I use my own domain?

Yes! You can add a custom domain (e.g., app.yourcompany.com) to any service.

To add a custom domain:

1. Go to your service page
2. Open the Configuration tab
3. Add your custom domain in the Custom Domain section
4. Configure your DNS by adding an A or AAAA record pointing to your service's IP address
5. Click Verify to confirm DNS is configured correctly

Once verified, your custom domain will become active. For stable deployments, your service's ingress is configured with both the default domain (*.apps.rock8.cloud) and your verified custom domain, allowing traffic to reach your service from either address.

v1 Limitations:

• One custom domain per service (no alias lists)
• Manual DNS configuration required (no automated setup)
• No wildcard domains (e.g., *.app.yourcompany.com)
• DNS verification uses A/AAAA record lookup only
• Verification may fail temporarily due to DNS propagation; retry if needed

Preview deployments always use auto-generated preview URLs and are not affected by custom domain configuration.

Are SSL certificates included?

Yes! All services get:

• Automatic SSL certificates
• Automatic renewal
• HTTPS by default
• HTTP → HTTPS redirect

No configuration needed.

Why can't I access my deployed app?

Common issues:

• Wait 1-2 minutes after deployment
• Verify port in settings matches Dockerfile's EXPOSE
• Check container logs for errors

GitHub Integration

Which GitHub repositories can I connect?

Any repository where the Rock8Cloud GitHub App is installed:

• Personal repositories
• Organization repositories
• Private repositories
• Public repositories

Can I deploy from GitLab or Bitbucket?

Currently only GitHub is supported. GitLab and Bitbucket support is planned.

Do you support monorepos?

Yes! Deploy multiple services from the same repository by using different Dockerfile paths. Rock8Cloud auto-scans your repository for Dockerfiles during deployment configuration.

We use Rock8Cloud to deploy Rock8Cloud itself, so we're confident it works well with monorepos.

What happens if I delete my GitHub repository?

Your deployed services continue running, but:

• Can't trigger new deployments
• Can't redeploy from GitHub
• Need to reconnect to a different repository

Preview Deployments

What are preview deployments?

Temporary deployments for pull requests. Each PR gets its own URL:

https://your-service-pr123.apps.rock8.cloud

Great for testing changes before merging!

How do I enable preview deployments?

1. Go to your service's Workflows tab
2. Enable the Preview Deployments workflow (enabled by default)
3. Configure source branch patterns if needed (defaults to feat/*)

New PRs matching your branch patterns will automatically deploy.

Do preview deployments use the same database?

Yes, preview deployments use the same environment variables as your main deployment, including database connections.

If you need separation, create a separate project or service with its own database for preview/staging purposes.

When are previews deleted?

Automatically when you:

• Close the pull request
• Merge the pull request

No manual cleanup needed!

Security

Are my private repositories secure?

Yes:

• Code is only accessed during builds
• Build contexts are isolated
• Images stored in private registry
• Only your organization members can access

Who can see my deployments?

Only members of your organization in Rock8Cloud. Deployments, logs, and environment variables are private.

Deployed apps (URLs) are publicly accessible if you share the link.

Are databases isolated?

Yes! Databases are network-isolated:

• Only accessible from services in same project
• Not accessible from internet
• Not accessible from other projects

Organization & Teams

Can multiple people access my projects?

Yes! Invite team members to your organization:

• Shared access to all projects
• View deployments and logs
• Trigger deployments
• Manage environment variables

How do I invite team members?

1. Go to Settings
2. Click Members
3. Click Invite Member
4. Enter their email and assign a role
5. They'll receive an invitation

Can I control permissions?

Yes! Rock8Cloud supports three roles: Owner, Admin, and Member. Owners have full access including organization deletion. Admins can manage members and settings. Members can view and deploy.

See Teams and Organizations for the full permissions matrix.

Performance

How do I scale my application?

Replicas are currently limited to 1 per service. Scaling with multiple replicas will be available in a future release.

What about auto-scaling?

Auto-scaling based on CPU/memory is planned for future releases.

Where are applications hosted?

Applications run on Rock8Cloud's managed cloud infrastructure.

Pricing & Limits

What plans are available?

Rock8Cloud offers three plans:

All plans include a free trial. See Plans & Usage for full details.

For organizations with requirements beyond the Neptun plan, contact us about our Enterprise tier.

Testing the billing flow

Rock8Cloud is currently in beta testing. You can use Stripe's test card number 4242 4242 4242 4242 with any future expiration date and any CVC to test the billing flow without being charged.

What happens when I hit a limit?

• Pod limit — you cannot deploy new services or create new preview environments. Existing services continue running.
• Build minutes — new builds are rejected. Redeployments of already-built images still work.
• AI agent runs — AI code analysis and AI coder will not trigger until the period resets.

See Plans & Usage for details on usage periods and limits.