How to install Maxun on a Cloud VPS

Maxun is a no-code platform for web data extraction: you build robots that collect data from websites by pointing and clicking, with no scraping code to write.

Running the tool on your own server means unlimited use without sending data to external services.

One-click install on cloudlinux.ro

The fastest way: Maxun installs automatically at the first boot of a new server.

1. Create a Cloud VPS from the control panel.
2. In the configuration step, pick Maxun from the app catalog.
3. Start the server. The install runs in the background for a few minutes and its status shows on the server page.
4. Access details and generated passwords are saved on the server in /root/app-credentials.txt. The app will be available on port 5173.

Manual install on any Ubuntu server

If you prefer doing it yourself, below is the exact script our automatic install runs. Execute it as root on a fresh Ubuntu server (24.04 recommended). It stops at the first error, and when it finishes you will find the access details in /root/app-credentials.txt.

export DEBIAN_FRONTEND=noninteractive
curl -fsSL https://get.docker.com | sh
IP=$(hostname -I | awk '{print $1}')
mkdir -p /opt/maxun && cd /opt/maxun
curl -fsSL -o docker-compose.yml https://raw.githubusercontent.com/getmaxun/maxun/master/docker-compose.yml
JWT_SECRET=$(openssl rand -hex 32)
SESSION_SECRET=$(openssl rand -hex 32)
ENCRYPTION_KEY=$(openssl rand -hex 32)
DB_PASSWORD=$(openssl rand -base64 24 | tr -dc 'A-Za-z0-9' | cut -c1-20)
MINIO_ACCESS_KEY=$(openssl rand -hex 12)
MINIO_SECRET_KEY=$(openssl rand -hex 20)
cat > .env <<EOF
NODE_ENV=production
JWT_SECRET=$JWT_SECRET
SESSION_SECRET=$SESSION_SECRET
ENCRYPTION_KEY=$ENCRYPTION_KEY
DB_NAME=maxun
DB_USER=postgres
DB_PASSWORD=$DB_PASSWORD
DB_HOST=postgres
DB_PORT=5432
MINIO_ENDPOINT=minio
MINIO_PORT=9000
MINIO_CONSOLE_PORT=9001
MINIO_ACCESS_KEY=$MINIO_ACCESS_KEY
MINIO_SECRET_KEY=$MINIO_SECRET_KEY
OLLAMA_BASE_URL=http://host.docker.internal:11434
BACKEND_PORT=8080
FRONTEND_PORT=5173
BACKEND_URL=http://$IP:8080
PUBLIC_URL=http://$IP:5173
VITE_BACKEND_URL=http://$IP:8080
VITE_PUBLIC_URL=http://$IP:5173
BROWSER_WS_PORT=3001
BROWSER_HEALTH_PORT=3002
BROWSER_WS_HOST=browser
MAXUN_TELEMETRY=false
EOF
docker compose up -d
printf 'Maxun: http://%s:5173\nCreeaza-ti contul din interfata la prima accesare, prin Register.\nAPI backend: http://%s:8080\nDaca folosesti firewall, deschide porturile 5173 si 8080.\n' "$IP" "$IP" > /root/app-credentials.txt

You can also save this script as a recipe in your account and reuse it on any new server.