Skip to content

Installation

Requirements

Section titled “Requirements”
  • Python 3.12+
  • uv (recommended) or pip
  • Ansible (for deployments)

Quick Install

Section titled “Quick Install”

  1. Install slipp

    Terminal window
    uv tool install slipp

  2. Verify installation

    Terminal window
    slipp --version

  3. Enable shell completion (optional)

    Terminal window
    slipp --install-completion bash
    source ~/.bashrc

Install from GitHub

Section titled “Install from GitHub”

For the latest development version:

Terminal window
uv tool install git+https://github.com/angelsen/slipp

Development Setup

Section titled “Development Setup”

For contributing or local development:

  1. Clone the repository

    Terminal window
    git clone https://github.com/angelsen/slipp.git
    cd slipp

  2. Install dependencies

    Terminal window
    uv sync

  3. Run slipp

    Terminal window
    uv run slipp --help

Provisioning a VPS with Gigahost

Section titled “Provisioning a VPS with Gigahost”

You don’t need to bring your own VPS — slipp can order and bootstrap one for you via Gigahost:

  1. Add the provider

    Terminal window
    slipp providers add gigahost

    Prompts for a Gigahost API key and verifies it.

  2. Provision and deploy in one command

    Terminal window
    slipp up myapp --domain myapp.example.com

    Orders a VPS, bootstraps the slipp service account, registers (or registers-and-syncs) the domain, generates the deployment with slipp launch, converges DNS, and runs slipp deploy — end to end.

    Or do it in stages: slipp provision myapp (order + bootstrap only), then slipp launch/slipp deploy as usual.

See slipp up, slipp provision, and slipp server install (OS reinstall + resumable bootstrap) for the full command set.

Next Steps

Section titled “Next Steps”