Troubleshooting¶

Services not accessible via domain names¶

If you can't access services using their domain names (e.g., https://grafana.plift.local):

Check if hosts file is installed:
```
cat /etc/hosts | grep plift.local
```

Reinstall hosts file:

sudo cat generated_configs/default/hosts >> /etc/hosts

Verify DNS resolution:

ping grafana.plift.local
# Should resolve to 127.0.0.1

SSL certificate warnings in browser¶

If you see "Your connection is not private" or certificate warnings:

Verify CA certificate exists:

ls -la generated_configs/ssl/rootCA.pem

Import the CA certificate:

Linux:

sudo cp generated_configs/ssl/rootCA.pem /usr/local/share/ca-certificates/plift-ca.crt
sudo update-ca-certificates

macOS:

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain generated_configs/ssl/rootCA.pem

Windows: - Double-click generated_configs/ssl/rootCA.pem - Click "Install Certificate" - Select "Local Machine" → "Trusted Root Certification Authorities"

Firefox (all platforms): - Settings → Privacy & Security → Certificates → View Certificates - Click "Import" and select rootCA.pem - Check "Trust this CA to identify websites"

Regenerate certificates (if needed):
```
plift generate c=ssl
```

Salt container not starting¶

# Rebuild the Salt container
plift build-salt

# Start base containers
plift start-base

# Check logs
plift logs c=salt

Configs not generating¶

Check that Salt container is running:

plift status
plift start-base

Check Salt logs for errors:

plift logs c=salt

Port conflicts¶

Edit port bindings in configuration files:

Services: configs/services/init.sls
Tools: configs/tools/init.sls
Apps: configs/apps/init.sls

Then regenerate:

plift generate c=services  # or tools, apps

Database connection issues¶

Ensure database service is running:

plift start-services s=mysql  # or postgresql

Check database credentials in app configs
Run migrations:
```
plift migrate-databases
```

Grafana dashboards not showing¶

Import dashboards manually:
```
./scripts/import-grafana-dashboards.sh
```

Reset and regenerate:

./scripts/reset-dashboards.sh
plift generate c=grafana

Check Grafana logs:
```
plift logs c=grafana
```

SSL certificate issues¶

Regenerate certificates:

plift mkcert
plift restart-base  # Restart HAProxy if needed

Container permissions issues¶

Some containers need specific permissions:

# Grafana data directory
sudo chown -R 472:472 docker/data/grafana

# Or use the prepare command
plift prepare-grafana-dir

General debugging¶

# View all container status
plift status

# View logs for specific container
plift logs c=container_name

# Attach to container shell
plift attach c=container_name

# Attach as root
plift attach-root c=container_name

# Clean everything and start fresh
plift clean
plift init