Skip to content

Quick Start

Deploy your first application to a VPS in 5 minutes.

Prerequisites

Section titled “Prerequisites”
  • slipp installed (Installation)
  • VPS with SSH access
  • A project to deploy (any app with a Dockerfile or detectable framework)

Deploy Your App

Section titled “Deploy Your App”

  1. Navigate to your project

    Terminal window
    cd your-project

  2. Generate Ansible configuration

    Terminal window
    slipp launch --name myapp

    This scans your codebase and generates deployment files:

    • Directoryinventory/
      • hosts
    • Directorygroup_vars/
      • all.yml
    • Directoryroles/
      • Directorymyapp/
        • …
    • playbook.yml
    • slipp.yaml
    • Dockerfile (if needed)

  3. Configure your VPS

    Edit inventory/hosts with your server details:

    all:
      hosts:
        myserver:
          ansible_host: 192.168.1.100
          ansible_user: slipp

  4. Deploy

    Terminal window
    slipp deploy

  5. Verify

    Terminal window
    slipp ps

What Just Happened?

Section titled “What Just Happened?”

slipp generated a complete Ansible deployment and ran it on your VPS:

  1. Scanned your project for services (Docker Compose, Dockerfile, etc.)
  2. Generated Ansible roles, playbook, and inventory
  3. Deployed via ansible-playbook
  4. Registered the project for future operations

Basic Operations

Section titled “Basic Operations”

Now that your app is deployed:

Terminal window
# List running services
slipp ps


# View logs
slipp logs myapp -f


# Execute commands in container
slipp exec myapp "ls -la"


# SSH to VPS
slipp ssh

Common Issues

Section titled “Common Issues”

Next Steps

Section titled “Next Steps”