Complete guide to deploying containerized applications to dstack with step-by-step instructions
We’ve come a long way from the first steps of installing dstack. Now, let’s deploy your first application.
If you already have access to a dstack host (for example, someone else has installed and set up the hardware and dstack runtime for you), you can deploy your application directly to their dstack instance. If you need to review or complete the installation and setup steps for your own dstack host, go back to the previous section: Step 4 – Install dstack Runtime. That section covers the full dstack installation and build process before you reach this deployment guide.
Step | What to Do & What You’ll See |
---|---|
1. Configure Container | ![]() Select the container image you want to deploy and specify which ports should be exposed. |
2. Set Basic Settings | ![]() Enter a name for your application and choose the deployment type (e.g., web service, job, etc.). |
3. Secure Environment | ![]() Add any environment variables your app needs. Mark sensitive variables to encrypt them for extra security. |
4. Review Variables | ![]() Double-check all environment variables and settings. Make sure everything is correct before proceeding. |
5. Launch Application | ![]() Click to deploy your application. dstack will start the deployment process on the infrastructure. |
6. Check Deployment Status | ![]() Once deployed, your application will appear in the deployment list. You can monitor its status here. |
What to Check | What to Do & What You’ll See |
---|---|
VMM Status | ![]() Open the VMM dashboard to confirm your application appears in the list and is marked as running. See example screenshot. |
System Logs | ![]() Check the system and application logs for any errors or warnings. This helps you verify that the node and your app started up correctly. See example screenshot. |
Live Monitoring | ![]() Use the live log viewer to watch your application’s output in real time. This is useful for troubleshooting and confirming your app is running as expected. See example screenshot. |
Access Check | ![]() Test your application’s endpoint (such as a web URL or API) to make sure it is accessible from your browser or API client. See example screenshot. |
Final Validation | ![]() Your application is now fully deployed and running on dstack. For reference, here’s a live example: see deployed app. Visit your own app’s endpoint or UI to confirm it loads and works as expected. If you can see and interact with your app, your deployment is complete and your app is running securely on a confidential VM. |