ɳSelfɳSELFDOCS

  • Getting Started

    • Introduction
    • Quick Start
    • Installation
    • Your First Project

  • Core Concepts

    • Architecture Overview
    • Project Structure
    • Configuration
    • Environments

  • Services

    • PostgreSQL Database
    • Hasura GraphQL
    • Authentication
    • Real-Time Communication
    • Storage (MinIO)
    • Email Configuration
    • Redis Cache
    • Search Engines
    • Functions
    • MLflow (ML Tracking)
    • Monitoring & Metrics
    • Admin UI
    • Dashboard

  • Database Tools

    • Schema Management
    • Migrations
    • Seeding Data
    • Backup & Restore
    • dbdiagram.io Sync

  • Microservices

    • NestJS Services
    • BullMQ Workers
    • Go Services
    • Python Services

  • CLI Reference

    • Complete Command Reference
    • Core Commands
    • Database Commands
    • Service Management
    • Production Commands

  • Deployment

    • Local Development
    • Production Setup
    • SSL/TLS Configuration
    • Domain Configuration
    • Environment Variables

  • Advanced Topics

    • Multi-Tenancy & SaaS
    • Security & Hardening
    • Custom Actions
    • Webhooks
    • Performance Tuning
    • Troubleshooting

  • Migration Guides

    • From Supabase
    • From Nhost
    • From Firebase

  • Resources

    • Changelog
    • Licensing
    • FAQ
    • Contributing
    • Support

Plugin Installation

This guide covers how to install, configure, update, and manage ɳSelf plugins. Plugins extend ɳSelf with third-party service integrations.

Before Installing

1. Set Required Environment Variables

Each plugin requires specific environment variables. Add them to your .env file before installing:

# Add to .env
echo "STRIPE_API_KEY=sk_test_xxx" >> .env

2. Verify API Access

Check that the plugin requirements are met:

# Check plugin requirements
nself plugin install stripe --check-env

Tip

Run the --check-env flag to verify all required environment variables are set before the actual installation.

Installing Plugins

From Official Registry

# List available plugins
nself plugin list

# Install a plugin
nself plugin install stripe

# Install specific version
nself plugin install stripe@1.0.0

From Local Path

For development or custom plugins:

nself plugin install ./path/to/my-plugin

From Git Repository

nself plugin install https://github.com/user/nself-plugin-custom.git

Configuration

1. Add Environment Variables

Each plugin requires specific environment variables. Add them to your .env file:

# Stripe Plugin
STRIPE_API_KEY=sk_live_xxx
STRIPE_WEBHOOK_SECRET=whsec_xxx

# Shopify Plugin
SHOPIFY_STORE_URL=mystore.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_xxx

2. Apply Database Schema

The plugin schema is applied automatically during installation. To verify:

nself plugin stripe status

3. Initial Data Sync

Sync existing data from the service:

nself plugin stripe sync

Managing Plugins

Check Status

# Status of all plugins
nself plugin status

# Status of specific plugin
nself plugin stripe status

Update Plugins

# Update all plugins
nself plugin update

# Update specific plugin
nself plugin update stripe

Remove Plugins

# Remove plugin (keeps data)
nself plugin remove stripe

# Remove plugin and data
nself plugin remove stripe --delete-data

Webhook Configuration

Plugins that support webhooks need endpoint configuration in the external service.

1. Get Your Webhook URL

Your webhook endpoint is:

https://your-domain.com/webhooks/<plugin-name>

For local development:

https://local.nself.org/webhooks/stripe

2. Configure in External Service

For Stripe:

  1. Go to Stripe Dashboard > Webhooks
  2. Click "Add endpoint"
  3. Enter your webhook URL
  4. Select events to listen for
  5. Copy the signing secret to STRIPE_WEBHOOK_SECRET

3. Verify Webhooks

# Check webhook status
nself plugin stripe webhook status

# View recent events
nself plugin stripe webhook events

Troubleshooting

Plugin Not Found

Error: Plugin 'xyz' not found in registry

Check available plugins: nself plugin list

Database Connection Failed

Error: Could not connect to PostgreSQL

Ensure your ɳSelf project is running: nself status

Missing Environment Variables

Error: STRIPE_API_KEY is not set

Add the required variable to your .env file.

Webhook Signature Failed

Error: Webhook signature verification failed

Ensure STRIPE_WEBHOOK_SECRET matches the signing secret from Stripe Dashboard.

Requirements

  • ɳSelf v0.4.8 or later
  • Docker and Docker Compose
  • Running ɳSelf project (nself start)
  • PostgreSQL 14+
  • Node.js 20+ (for TypeScript plugins)

Next Steps

  • Plugin Overview - Learn about the plugin system
  • Stripe Plugin - Payment integration guide
  • GitHub Plugin - Repository sync guide
  • Shopify Plugin - E-commerce integration guide
  • Creating Plugins - Build your own plugins

Last Updated: January 2026 | Version 0.4.8