nusaas@self-host:~$ [troubleshooting-guide]
[docker-hub]
> cat purpose.txt

Self-host NUSAAS on your own infrastructure.

Run the production NUSAAS ERP and POS stack on infrastructure you control, using maintained Docker images and configuration templates.

// QUICK_START

installer.sh
$

// The installer creates the backend and frontend env files, provisions MySQL, and starts the [REDACTED] stack.

Docker Hub Download Compose File

// THE_STACK

app

Application Runtimes

API, React frontend, queue worker, scheduler, and Reverb WebSocket server. Documentation remains managed at docs.nusaas.com.

data

Private Data Services

MySQL 8, Redis 7, and Meilisearch on an internal Docker network with persistent volumes.

ops

Operations

Automatic HTTPS, health checks, pinned releases, local backup tooling, and seeded initial administration.

> configure --guided

Build your installation command

These values are processed only in your browser. Passwords and generated secrets are never collected here; the installer requests or creates them directly on your server.

generated command · NuSaaS 1.0.12

    

    

  


  
  

    

      
> ls -l guides/

      
Installation Walkthrough

      
Watch the interactive installer wizard execute in real time.

    

    
    

      
      

        

          [01]
          

            
Fetch Script

            
Download the secure installer script directly into your server directory.

            

              curl -fsSL https://get.nusaas.com/install.sh -o install.sh
            

          

        

        

          [02]
          

            
Execute Wizard

            
Run the installer to configure domains, MySQL, SMTP, the first administrator, and cryptographic secrets.

            

              bash install.sh
            

          

        

        

          [03]
          

            
Open your ERP workspace

            
Register the business owner, verify email, and complete onboarding in your own ERP workspace.

            

              https://app.yourdomain.com
            

          

        

      

      
      
      

        
// SIMULATED_INSTALL

        

          
          

            

              
              
              
            

            interactive-demo.sh
            

          

          
          

            
          

        

      

    

  


  
  

    
Connect your business services

    
Use your own provider accounts. Installation does not activate payments, fiscal submission or a WhatsApp gateway.

    

      
M-Pesa
Save your Daraja credentials in ERP payment settings, verify HTTPS callbacks and enable the payment method for each sales channel.
M-Pesa setup guide

      
KRA eTIMS / OSCU
Use your business registration and device. Begin in sandbox; production needs your KRA approval and explicit operator authorization. NuSaaS does not provide managed eTIMS.
KRA eTIMS setup guide

    

    
Self-hosted distribution is temporarily restricted. Images require an authorized Docker Hub account. Run docker login on your server before installation. Version 1.0.12 is the existing image release; the latest cloud updates are not included.

  


  

    

      
> ls -lh config/

      
Manual Deployment Assets

      
Manual installs require Compose, both environment templates and Caddy routing. The revised image-only package excludes the private console and NuSaaS billing.

    

    
    
    

      
      

        
PERMISSIONS

        
SIZE

        
FILENAME

        
ACTIONS

      

      
      

        
        

          
-rwxr-xr-x

          
~22 KB

          
install.sh

          

            
            Download
          

        

        
        

          
-rw-r--r--

          
~7 KB

          
docker-compose.yml

          

            
            Download
          

        

        
        

          
-rw-r--r--

          
~4.5 KB

          
.env.selfhosted

          

            
            Download
          

        

        
        

          
-rw-r--r--

          
~2 KB

          
.env.frontend

          

            
            Download
          

        

      

    

    
# Manual placement and validation
mkdir -p web
mv .env.selfhosted .env
mv .env.frontend web/.env.frontend
cp Caddyfile.example Caddyfile
nano .env && nano web/.env.frontend && nano Caddyfile
docker compose config --quiet

    
Manual routing: Caddyfile example. Optional operator-managed services: Cloudflare Tunnel overlay, Evolution overlay, gateway environment template. Configure your own credentials and reviewed image versions before use. Register your business owner and complete email verification/onboarding after installation.