How to Deploy JetBrains Junie Projects on Vultr Using Dokploy

Junie is an agentic AI assistant integrated with JetBrains IntelliJ IDEA that automates modern application development by generating full-stack application code from a prompt. Dokploy is an open-source platform-as-a-service that offers a stable environment for hosting Docker-based deployments, with support for database and SSL certificate management.

This guide explains how to install Intellij IDEA with Junie, generate a full-stack application, and deploy the resulting code to a Vultr instance with Dokploy.

Prerequisites

Before you begin, you need to:

• Have an active JetBrains account.
• Have a GitHub account.
• Have access to an Ubuntu 24.04 server as a non-root user with sudo privileges.
• Install Dokploy and create your administrator account.

Set Up Junie in a JetBrains IDE

Prepare your development environment by installing the IDE (Integrated Development Environment) and the required AI plugins.

1. Download and install IntelliJ IDEA.
2. Open the application and create a new project.
3. Set the project type to Empty Project or select your preferred framework configuration.
4. Click the Junie icon in the right toolbar.
5. Log in to your JetBrains account when prompted.

Create an Application Using AI

Use natural language prompts to generate application code and Docker configuration files.

1. Provide a detailed description of your application in the chat prompt field. Specify your technology stack and instruct the agent to make the application compatible with Dokploy. Request a Dockerfile or a docker-compose.yaml file to ensure the application is ready for containerization.
2. Click Install and Continue to allow Junie to generate the codebase.

Push the Project to GitHub

Initialize a local Git repository and link it to GitHub to prepare for the Dokploy deployment pipeline.

1. Open the integrated terminal by pressing Alt + F12 on Windows/Linux or Opt + F12 on macOS.

2. Create a new repository on GitHub via the web interface.

3. Initialize the local repository.

   CONSOLE

   Copy

   $ git init

   Explain Code

   Powered by Vultr AgentBeta

4. Stage the generated files for commit.

   CONSOLE

   Copy

   $ git add .

   Explain Code

   Powered by Vultr AgentBeta

5. Commit the files to your local repository.

   CONSOLE

   Copy

   $ git commit -m "Initial commit"

   Explain Code

   Powered by Vultr AgentBeta

6. Set the default branch to main.

   CONSOLE

   Copy

   $ git branch -M main

   Explain Code

   Powered by Vultr AgentBeta

7. Add your GitHub repository as a remote. Replace YOUR_REPOSITORY_URL with your repository's URL.

   CONSOLE

   Copy

   $ git remote add origin YOUR_REPOSITORY_URL

   Explain Code

   Powered by Vultr AgentBeta

8. Push the source code to GitHub.

   CONSOLE

   Copy

   $ git push -u origin main

   Explain Code

   Powered by Vultr AgentBeta

Connect GitHub Repository

Connect your GitHub account with Dokploy to grant it access to pull code from your repositories.

1. Open the Dokploy dashboard in a web browser. If you have a domain configured for your Dokploy instance, navigate to it directly. Otherwise, use your instance’s IP address on port 3000 (like 192.0.2.1:3000).
2. Log in to the administrator account.
3. Select Git under Settings in the left sidebar.
4. Click GitHub, then click Create GitHub App.
5. Follow the GitHub OAuth prompts to authorize the app and select the repositories Dokploy can access.

Create a New Project

Projects in Dokploy isolate different application environments.

1. Click Projects in the left sidebar.
2. Click Create Project, enter a project name, and click Create.
3. Click on the newly created project to open it.

Connect the Code Repository

Deploy the application by specifying the source repository and creating a new Docker Compose service.

1. On your project page, click Create Service and select Compose.

2. Enter a name for your service and click Create.

3. Open your new Compose service.

4. Locate the GitHub configuration section.

5. Select your GitHub account and repository.

6. Set the correct Branch.

7. Click Save to apply the repository settings.

8. Open the docker-compose.yaml file in your local repository and make the following two adjustments to the web service before deploying:

   • Remove any ports: mappings. Dokploy routes traffic through Traefik, and the web service does not need to bind a port on the host.
   • Add dokploy-network to the service's networks so Traefik can reach the container:
   YAML

   Copy

   services:
     web:
       networks:
         - default
         - dokploy-network
   
   networks:
     dokploy-network:
       external: true

   Explain Code

   Powered by Vultr AgentBeta

   Replace web with the actual service name from your compose file.

9. Commit and push the changes to your repository.

Configure Environment Variables

Environment variables securely provide sensitive values, such as API keys or secret tokens, to the container without hardcoding them.

1. In your application’s configuration page, click the Environment tab.

2. Each line defines a new environment variable as a key-value pair (KEY=VALUE). Environment variable examples include:

   • NODE_ENV: Specifies the deployment environment, such as development or production.
   • API_SECRET_KEY: A secure key for accessing an API.
   • DATABASE_URL: The connection string for database access.
   • NEXT_PUBLIC_ANALYTICS_ID: A variable accessible by the browser/client code.

3. Enter your variables and click Save.

Start the Deployment

Dokploy automatically fetches the source code and creates the required Docker containers upon deploying your application.

1. Switch to the General settings tab.
2. Click Deploy, then click Confirm.
3. Click View to monitor the real-time deployment logs.

Verify Deployment

Connect your domain for a production-ready URL and encrypted traffic. Dokploy provisions a Let’s Encrypt SSL certificate through Traefik when you enable HTTPS.

1. Navigate to the Domains tab and click Add Domain.
2. Select the name of your web service container in the Service Name field, for example web.
3. Type your custom domain into the Host field.
4. Enable the HTTPS toggle.
5. Select Let’s Encrypt from the Certificate Provider dropdown.
6. Click Create.
7. Click Validate DNS to verify your domain’s DNS configuration.

Add a Database

Dokploy supports deploying managed database containers within the same project. The internal connection URL connects the database directly to your application over Docker’s internal network without exposing it to the internet.

1. Navigate to your project page.
2. Click Create Service and select Database.
3. Select the database type that matches your application’s requirements.
4. Enter a name for the database and click Create.
5. Open the database service page and click Deploy.
6. Copy the Internal Connection URL.
7. Go to the Environment tab in your application’s configuration page.
8. Create or update the DATABASE_URL variable and paste the copied connection URL as the value.
9. Click Save.

Configure CI/CD Pipeline

Dokploy automatically redeploys applications whenever you push new code to the GitHub repository. Verify that automatic deployments work.

Test the CI/CD Pipeline

Make a small change to your code and push it.

1. Make a small, visible change to your application's code.

2. Stage the modified files.

   CONSOLE

   Copy

   $ git add .

   Explain Code

   Powered by Vultr AgentBeta

3. Commit the change.

   CONSOLE

   Copy

   $ git commit -m "Test automatic deployment"

   Explain Code

   Powered by Vultr AgentBeta

4. Push the change to your GitHub repository.

   CONSOLE

   Copy

   $ git push origin main

   Explain Code

   Powered by Vultr AgentBeta

5. Click the Deployments tab in the top navigation bar of your Dokploy application’s configuration page.

6. Verify that a new deployment process is running at the top of the list.

Conclusion

You have successfully generated a full-stack application using Junie, pushed it to GitHub, and deployed it to a Vultr instance using Dokploy with HTTPS and an automated CI/CD pipeline. For more information and advanced configuration options, visit the official Dokploy documentation.