How to Add Ip Camera Shinobi

How to Add Ip Camera Shinobi

by

Shinobi is a powerful, free open-source video surveillance platform that lets you manage multiple IP cameras easily. This guide walks you through installing Shinobi on your server and connecting any IP camera—even older models—to start live viewing, recording, and alerts instantly. Whether you’re securing a home, office, or warehouse, Shinobi offers professional-grade features without the cost.

Quick Answers to Common Questions

Tip/Question?

Can I use Shinobi with battery-powered cameras like Ring or Arlo?

Not directly. Most consumer cameras don’t expose RTSP streams due to DRM or app restrictions. However, some advanced users exploit local network capture via tools like FFmpeg or third-party apps—but this may violate terms of service. For best results, stick to ONVIF/RTSP-compatible cameras.

Tip/Question?

Is Shinobi compatible with Windows?

Officially, Shinobi only supports Linux-based systems (including WSL on Windows 10/11). However, you can run it inside a Linux VM or via Docker Desktop for Windows. Performance may vary, so a native Linux install is preferred.

Tip/Question?

How much storage do I need for one camera?

Approximately 1–2 GB per day for HD (1080p) recording. Reduce this by enabling motion-only recording or lowering resolution. Use external USB drives or NAS for expandable storage.

Tip/Question?

Can multiple users view cameras simultaneously?

Yes! Create separate user accounts in Shinobi and assign camera permissions. Each user gets their own login—ideal for families or businesses with different access levels.

Tip/Question?

Does Shinobi work offline?

Absolutely. Once installed, Shinobi operates entirely on your local network. No internet needed for recording or viewing—perfect for remote cabins or areas with spotty connectivity.

How to Add IP Camera Shinobi: Complete Setup Guide

Are you tired of expensive surveillance systems that lock you into subscriptions or limited features? Want full control over your video footage without breaking the bank? Shinobi might be exactly what you need. This powerful, open-source video surveillance platform runs on almost any device—from a Raspberry Pi to a full desktop PC—and lets you connect virtually any IP camera for live viewing, recording, and smart alerts.

In this comprehensive guide, you’ll learn how to install Shinobi, connect your first IP camera, configure motion detection, and start monitoring your property—all in under an hour. Whether you’re protecting your home, small business, or remote site, Shinobi gives you professional-grade tools at zero cost. Let’s get started!

What Is Shinobi?

Shinobi is a modern, lightweight video surveillance software built for flexibility and ease of use. It supports hundreds of camera brands and types—including ONVIF, RTSP, MJPEG, and even USB-based webcams—making it ideal for DIY security projects. Unlike closed systems, Shinobi is completely free, community-driven, and highly customizable.

How to Add Ip Camera Shinobi

Visual guide about How to Add Ip Camera Shinobi

Image source: vignette.wikia.nocookie.net

With Shinobi, you can:

  • View live feeds from multiple cameras on one screen
  • Record motion-triggered clips automatically
  • Send instant alerts when activity is detected
  • Access your footage remotely via web browser or mobile app
  • Store videos locally or on external drives

Best of all, you own your data—there’s no cloud dependency unless you choose it. Ready to set it up? Let’s begin.

Prerequisites Before Installing Shinobi

Before adding your IP camera to Shinobi, make sure you have everything ready. Don’t worry—it’s simpler than it sounds!

Hardware Requirements

  • A computer, Raspberry Pi, or NAS device running Linux (Ubuntu, Debian, or Raspberry Pi OS work best)
  • At least 2GB RAM (4GB recommended for multiple cameras)
  • 10GB+ free storage space (for video recordings)
  • Stable internet connection (local network access is fine too)

Software & Network Prep

  • An active IP camera with RTSP or ONVIF support (most modern PoE or Wi-Fi cameras qualify)
  • The RTSP stream URL from your camera (found in its settings menu or manual)
  • A static IP address or reliable hostname for your Shinobi host (e.g., shinobi.local)
  • Basic command-line knowledge (we’ll walk you through each step)

If you’re unsure whether your camera supports RTSP, check the manufacturer’s specs or search online using your model number + “RTSP URL”. Most brands like Hikvision, Dahua, Amcrest, Reolink, and even some Wyze and TP-Link models offer this feature.

Step 1: Install Shinobi on Your Server

There are three main ways to install Shinobi: manually on Linux, via Docker, or on a Raspberry Pi. We recommend starting with the manual method for beginners—it’s straightforward and gives you full control.

Option A: Manual Installation (Recommended for Beginners)

  1. Open a terminal window on your Linux machine.
  2. Update your package list: 
    sudo apt update && sudo apt upgrade -y
  3. Install required dependencies: 
    sudo apt install git curl ffmpeg mysql-server mysql-client nginx php-fpm unzip -y
  4. Create a dedicated user for Shinobi: 
    sudo adduser shinobi
  5. Switch to the new user: 
    su - shinobi
  6. Clone the Shinobi repository: 
    git clone https://github.com/ShinobiCCTV/Shinobi.git $HOME/shinobi
  7. Make scripts executable: 
    cd $HOME/shinobi; chmod +x *.sh
  8. Run the installer script: 
    ./install.sh

The installer will prompt you for database credentials and admin login details. Write these down—you’ll need them later!

Option B: Docker Installation (Faster Setup)

  1. Install Docker and Docker Compose: 
    curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker
  2. Create a docker-compose.yml file: 
    version: '3'
services:
  shinobi:
    image: linuxserver/shinobi:latest
    container_name: shinobi
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Your/Timezone
    volumes:
      - ./config:/config
      - ./recordings:/recordings
    ports:
      - "8080:8080"
    restart: unless-stopped
  3. Start Shinobi: 
    docker-compose up -d

Both methods work great—choose based on your comfort level. Once installed, open your browser and go to http://your-server-ip:8080. You should see the Shinobi login page.

Step 2: Log In and Access the Dashboard

After installation, log in using the username and password you created during setup. If you used Docker, default credentials are usually admin/admin—but change them immediately!

Once logged in, you’ll land on the Dashboard. This is where you manage all your cameras, users, groups, and recordings. Familiarize yourself with the left sidebar menu:

  • Cams: Manage individual cameras
  • Groups: Organize cameras by location or purpose
  • Users: Create sub-accounts with custom permissions
  • Monitor: View all camera feeds at once
  • Recordings: Access saved video clips

Now let’s add your first IP camera.

Step 3: Connect Your IP Camera to Shinobi

This is the core part—adding your camera so Shinobi can view and record from it. The process varies slightly depending on your camera type, but we’ll focus on the universal method using RTSP.

Find Your Camera’s RTSP Stream URL

  1. Log into your camera’s web interface (usually via its IP address in a browser).
  2. Look for “Network”, “Streaming”, or “RTSP” settings.
  3. Common RTSP formats include:
    • rtsp://username:password@camera_ip:554/stream1
    • rtsp://admin:12345@192.168.1.100:554/live.sdp
  4. Test the URL in VLC Media Player first to confirm it works.

Add the Camera in Shinobi

  1. Go to Cams > Add New Cam.
  2. Fill out the form:
    • Name: Give it a friendly name (e.g., “Front Door Cam”)
    • Group: Select an existing group or create a new one
    • Monitor ID: Leave blank (Shinobi auto-generates this)
    • Stream Source: Paste your RTSP URL here
    • Type: Choose “FFmpeg”
    • Protocol: Select “RTSP”
    • Width/Height: Match your camera’s resolution (e.g., 1920×1080)
    • FPS: Usually 25 or 30
  3. Click Save.

Shinobi will attempt to connect. If successful, you’ll see a live preview. If not, check the error message—common issues include incorrect credentials, firewall blocking port 554, or unsupported codec.

Step 4: Configure Motion Detection & Alerts

One of Shinobi’s standout features is its smart motion detection. Instead of filling your drive with hours of useless footage, it only records when something moves.

Enable Motion Recording

  1. In your camera’s edit screen, scroll down to Motion tab.
  2. Check “Enabled”.
  3. Set Sensitivity (1–100). Higher = more triggers; lower = fewer but cleaner clips.
  4. Adjust Pre-event Buffer (seconds before motion starts to save).
  5. Define Recording Schedule (e.g., 24/7 or only at night).

Set Up Notifications

  1. Go to Settings > Notifications.
  2. Add a new notification method (Email, Telegram, or Pushover).
  3. For Email:
    • Enter SMTP server, port, and credentials
    • Test connection before saving
  4. Link the notification to your camera’s motion event.

Now, whenever motion is detected, you’ll get an instant alert—perfect for knowing if someone approaches your door after dark!

Step 5: Access Shinobi Remotely

Want to check your cameras while on vacation? No problem! Shinobi includes built-in reverse proxy and SSL support for secure remote access.

Enable HTTPS (Highly Recommended)

  1. In Settings > Reverse Proxy, turn it ON.
  2. Shinobi will generate a self-signed certificate (safe for testing).
  3. Access via https://your-domain-or-ip:8080

Use a Domain Name (Optional but Useful)

  1. Purchase a domain (e.g., mycameras.net) or use a dynamic DNS service like DuckDNS.
  2. Point the A record to your Shinobi server’s public IP.
  3. Update Shinobi’s reverse proxy settings to use your domain.

Now you can share https://mycameras.net with family or security personnel—securely and privately.

Troubleshooting Common Issues

Even with perfect instructions, things don’t always go smoothly. Here’s how to fix the most common problems.

Camera Won’t Connect

  • Double-check the RTSP URL format.
  • Ensure your camera uses standard H.264/H.265 codec.
  • Verify network connectivity: ping the camera from your Shinobi server.
  • Try lowering resolution or FPS in Shinobi settings.

High CPU Usage

  • Reduce camera resolution (e.g., 1280×720 instead of 4K).
  • Limit concurrent camera views.
  • Use hardware acceleration if available (Intel Quick Sync, NVIDIA NVENC).

No Recordings Saved

  • Check disk space: df -h in terminal.
  • Verify motion detection sensitivity and schedule.
  • Ensure Record checkbox is enabled in camera settings.

Login Issues After Update

  • Reset password via MySQL: mysql -u root -p -e "UPDATE shinobi.users SET password='newhash' WHERE user='admin'"
  • Reinstall Shinobi if database corrupted.

Conclusion: You’re All Set!

Congratulations! You’ve successfully added your IP camera to Shinobi and configured a fully functional surveillance system. From live viewing to motion-triggered alerts, you now have complete control over your security setup—without monthly fees or proprietary locks.

Remember, Shinobi is just the beginning. As you grow, you can add more cameras, integrate AI object detection plugins, or even build custom dashboards. The open-source community constantly adds new features, so stay updated by following their GitHub.

Whether you’re monitoring a backyard shed or managing a multi-location business, Shinobi scales with your needs. And best of all—you own your data, your rules, and your freedom.

Ready to expand? Try adding a second camera today and compare front-door vs. backyard coverage. The possibilities are endless!