Creating a Container App

There are two ways to create a container app: Custom creation (fully manual configuration) and From template (one-click deployment using a pre-configured template).

Before You Begin

• Identify the container image you want to deploy (from a public registry like Docker Hub, or a private registry).
• If using a private registry, prepare the registry URL, username, and password.
• Plan which ports and protocols you need to expose.
• If binding a custom domain, prepare the domain and configure the DNS in advance.

Custom Creation

Click Create App on the Container Hosting page and select Custom mode.

Select Region

Use the Region drop-down at the top of the page to choose the host location. The region determines physical location and network latency.

Currently only the Hong Kong region is available. More regions will be added in future updates.

App Name and Replicas

Parameter	Description
App Name	A display name for the app; auto-generated if left blank (e.g. app-{randomID})
Replicas	Number of concurrently running container instances (1–10), for high availability and load balancing

Configure Compute Resources

Parameter	Description	Range
CPU	CPU cores allocated per replica	0.25–16 cores (step 0.25)
Memory	Memory allocated per replica	512 MiB – 64 GiB (step 512 MiB)

Drag the sliders to adjust; the estimated cost updates in real time on the price panel.

Configure Container Image

Enter the image address in the Image field:

• Public image: Enter the image name directly (e.g. nginx:latest, postgres:16).
• Private image: Select the "Private" type, then fill in the registry server URL, username, and password.

Container Command and Arguments

• Command: Override the image's default start command.
• Args: Arguments to pass to the command — add multiple entries as needed.
• Environment Variables: Key-value pairs — add multiple entries as needed.

Docker Run Parser

If you already have a docker run command, click Parse Docker Run to paste it in. The parser automatically extracts the image, ports, environment variables, and volume mounts, saving you manual effort.

Configure Networking

Click Add Port to configure port mappings:

Parameter	Description
Container Port	The port the container listens on internally
Protocol	HTTPS (web traffic), WSS (WebSocket encrypted), TCP, or UDP
Public Host	Auto-assigned public access domain (format: *.app.resvrl.com); click to regenerate
Custom Domain	Optional: bind your own domain name. Supports CNAME validation or Cloudflare auto-configuration

HTTPS and WSS protocols automatically get SSL encryption. TCP and UDP protocols provide direct public port mappings.

Configure Storage Volumes

Click Add Volume to mount storage:

Parameter	Description
Name	Volume name
Type	Persistent volume (data survives app deletion) or Temporary volume (data is cleared when the container stops)
Mount Path	Mount point inside the container
Size	Storage capacity for persistent volumes (MB)

Submit the Order

Once the configuration is complete, the price panel at the bottom shows a real-time cost breakdown. To finalize:

1. Read and accept the terms of service and privacy policy.
2. Click Buy Now.
3. Choose a payment method in the payment drawer and complete the payment.
4. The system starts creating the container (status: Creating). It automatically transitions to Running once initialization completes.

The page polls for progress automatically during creation. If it times out (~10 minutes), an error is displayed.

Deploy from a Template

The template marketplace provides pre-configured templates for common applications, saving you tedious manual configuration.

Browse Templates

Click Create App → From Template on the Container Hosting page, or visit /container/templates directly.

The template list supports:

• Search (by name/keyword)
• Tag filtering
• Sorting (by popularity or newest)

Click a template card to view details including description, image, resource specs, ports, environment variables, and estimated cost.

Deploy a Template

1. Click Deploy on the template detail page.
2. Select the deployment region.
3. Configure the app name and environment variables (editable; env vars support random password generation).
4. Review the image, ports, and storage configuration (read-only).
5. Submit the order and pay.

The deployment flow is the same as custom creation — the template pre-fills most of the configuration.

After the Order is Placed

The system creates an order and enters the payment flow. After successful payment:

1. The container enters Creating status — the system pulls the image and deploys.
2. Once deployed, the status changes to Running, and the service becomes accessible.
3. You can view status, monitoring, logs, and events on the container detail page.

If deployment fails, the page shows an error analysis with suggested solutions.

Common Questions

The container won't start

Double-check the image name and verify that the registry credentials (for private images) are correct. The Events tab on the detail page shows detailed system events to help with troubleshooting.

How do I access the app over the internet?

The app detail page lists all public access URLs in the Network section. HTTPS ports get a https://*.app.resvrl.com address that you can open directly in your browser.

How do I modify the configuration after deployment?

Click the app on the list page to open its detail page, then click Edit to change CPU, memory, replicas, image, ports, and storage.

Will data in volumes be lost?

• Persistent volumes: Data is retained even after the app is deleted; it can be mounted by a new app.
• Temporary volumes: Data is automatically cleared when the container stops or is deleted.

How do I view container logs?

Switch to the Logs tab on the app detail page. You can select a container instance to view real-time logs, with auto-refresh and download support.

Related Guides

• Container Hosting Overview