Multi-Project Setup

Run multiple applications on a single VPS with shared infrastructure. slipp tracks projects globally so you can operate on any project from anywhere.

Project Registry

slipp maintains a global registry of projects:

slipp projects list

name          path                              registered
myapp         /home/user/projects/myapp         2024-01-15
auth-service  /home/user/projects/auth-service  2024-01-10
landing       /home/user/projects/landing       2024-01-05

Register a project

cd /path/to/myproject
slipp projects add myapp

Remove from registry

slipp projects remove myapp

Projects are also auto-registered on deploy.

Shared Infrastructure

Single VPS layout

Directory/home/user/
- Directoryprojects/
  - Directorymyapp/
    slipp.yaml
    Directoryinventory/
    …
  - Directoryauth-service/
    slipp.yaml
    Directoryinventory/
    …
  - Directorylanding/
    slipp.yaml
    Directoryinventory/
    …

All projects point to the same VPS in their inventories:

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

View all services

slipp ps

Shows services across ALL registered projects:

name       project       host          state    uptime
myapp      myapp         myserver      running  2d
postgres   auth-service  myserver      running  5d
nginx      landing       myserver      running  5d

Operations Across Projects

Target specific project

slipp ps -p auth-service
slipp logs postgres -p auth-service

Use host from any directory

slipp exec "df -h"  # Uses current project's host
slipp host myapp --ip  # Get IP for specific project

Shared secrets

Access vault from another project:

slipp run dev --vault shared-secrets --cmd "npm run dev"

Deployment Workflow

Deploy infrastructure first

Projects like databases should deploy before dependent apps:
Terminal window
```
cd auth-service
slipp deploy
```

Deploy applications

cd myapp
slipp deploy

cd landing
slipp deploy

Verify all services
Terminal window
```
slipp ps
```

Tag Presets

Create consistent presets across projects:

tag_presets:
  install: "--tags install-all"
  setup: "--tags setup-all --skip-tags start"
  restart: "--tags restart"

Use from any project:

slipp deploy install

Example: Full Stack Setup

Directoryprojects/
- Directoryinfrastructure/
  - slipp.yaml
  - Directoryinventory/
    …
  - Directoryroles/
    Directorypostgres/
    …
    Directoryredis/
    …
    Directorytraefik/
    …
- Directoryapi/
  - slipp.yaml
  - Directoryinventory/
    …
  - Directoryroles/
    Directoryapi/
    …
- Directoryfrontend/
  - slipp.yaml
  - Directoryinventory/
    …
  - Directoryroles/
    Directoryfrontend/
    …

Deploy order

# 1. Infrastructure (database, cache, proxy)
cd infrastructure && slipp deploy

# 2. Backend API
cd api && slipp deploy

# 3. Frontend
cd frontend && slipp deploy

Local development

# Frontend: tunnel to production, connect to remote API
slipp run dev \
  --cmd "npm run dev" \
  --tunnel-out 3000:app.example.com@myserver \
  --tunnel-in api:8000@myserver

Configuration

Project config (slipp.yaml)

name: myapp
inventory: inventory/hosts
playbook: playbook.yml
vault: inventory/host_vars/myserver/vault.yml

Global registry

Located at ~/.config/slipp/projects.json:

{
  "projects": [
    {
      "name": "myapp",
      "project_path": "/home/user/projects/myapp",
      "registered_at": "2024-01-15T10:30:00Z"
    }
  ]
}