Skip to main content
Peliqan supports two types of apps that can be built and deployed on Peliqan infrastructure:

​
Peliqan Machines

Peliqan Machines allow you to host your vibe coded web apps on Peliqan. These VMs are the next generation deployment environment from Peliqan. Compared to traditional Data Apps, vibe coded apps running on Peliqan Machines provide endless flexibility to build & deploy any type of app.

​
Deploying your vibe coded apps on Peliqan Machines

In Peliqan, in the left menu pane, go to Peliqan Machine: Pq Machines Menu Item Click on the button ”+ New machine” in the right top corner. Enter a name and short description. Based on the description, Peliqan AI will scaffold a boilerplate web app. Create Machine Wait for the machine to be provisioned. App Ready When the machine is ready, click on the button “Connect your agent” in the right top corner and follow the instructions:
  1. Install the Peliqan CLI on your local computer (prerequisites: Python3, OpenSSH should be installed)
  2. Sign in on Peliqan CLI with your Peliqan account
  3. Connect to your Peliqan Machine
  4. Download the instructions.md file for your coding agent (e.g. Claude Code).
Connect Agent The instructions.md file outlines the high-level sequence of operations for the agent to deploy your code, and it indicates where specific skill files are located within the generated base project files. Vibe code your app in your favorite environment (e.g. using Claude Code) and make sure to instruct your agent to read and follow the instructions in instructions.md. Ask your agent to deploy your app, it will use a secure SSH connection to your Peliqan Machine (using the peliqan CLI).

​
Preview app

You can preview your deployed app under “Preview”. You can copy the temporary preview URL of your app and use it outside of Peliqan: App Preview
The VM of your development environment (preview environment) will automatically shut down after some time of inactivity.

​
Browse files

You can see all deployed files of your project under “Code”. Code

​
Deployment logs

View the deployment logs for any errors.

​
Settings - General

Use Settings > General to e.g. restart your environment.

​
Settings - Environment

Use Settings > Environment to set environment variables such as:
  • PQ_API_KEY: API key from your Peliqan account, used to call the Peliqan API
  • PQ_BACKEND_URL: e.g. https://app.eu.peliqan.io if you are on the EU instance
You can ask your agent (e.g. Claude Code) to set these for you. Env

​
Publish to production

In order to make your app permanently available to users, you have to publish it to production, using the button “Publish to production” in the right top corner. You will be able to choose your own subdomain, for example: myNewApp.machines.eu.mydatacloud.com You can also link your own domain or subdomain by adding a CNAME record in your DNS to the above subdomain. Next, contact Peliqan Support to activate your custom domain. During deployment, a vulnerability scan will be performed on your app. You can find the detail under Production > Logs.

​
Peliqan as backend

Use Peliqan as the backend for your vibe coded apps, and allow multiple apps to share the same backend. Peliqan as a backend includes:
  • Authorization and authentication via Peliqan
  • Built-in Postgres database
  • Peliqan data warehouse (businesss data)
  • Peliqan writeback connectors (connect to your ERP, CRM…)
  • Run scheduled jobs (cron jobs) using scheduled Data Apps
More info:

​
Data apps

Data Apps are low-code single file Python scripts, using Streamlit for the UI. These are an alternative to vibe coded web apps. More info: Data Apps - low code Python