J0rsa Home Assistant Add-ons

High-quality Home Assistant add-ons for backup, AI, networking, and more

View project on GitHub

Installation Guide

Prerequisites

Before installing any add-ons from this repository, ensure you have:

  • ✅ Home Assistant OS, Supervised, or Container installation (Add-ons are not available for Core installations)
  • ✅ Supervisor version 2021.06.0 or newer
  • ✅ Sufficient storage space for the add-ons you want to install
  • ✅ Network connectivity for downloading add-on images

Adding the Repository

The easiest way to add our repository is by clicking the button below:

Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.

This will:

  1. Open your Home Assistant instance
  2. Navigate to the Supervisor Add-on Store
  3. Pre-fill the repository URL
  4. You just need to click “Add”

Method 2: Manual Installation

If the button doesn’t work for your setup, you can add the repository manually:

  1. Navigate to Supervisor
    • Open your Home Assistant web interface
    • Click on “Settings” in the sidebar
    • Select “Add-ons”
    • Click on “Add-on Store”
  2. Add Repository
    • Click the three dots menu (⋮) in the top right corner
    • Select “Repositories”
    • Add the following URL: 
      https://github.com/j0rsa/home-assistant-addons
    • Click “Add”
  3. Refresh the Store
    • Click the three dots menu (⋮) again
    • Select “Reload”
    • You should now see “J0rsa Add-ons” in the store

Installing Add-ons

Once the repository is added:

  1. Browse Available Add-ons
    • In the Add-on Store, scroll down to find the “J0rsa Add-ons” section
    • Click on any add-on to view its details
  2. Install an Add-on
    • Click on the add-on you want to install
    • Read the documentation tab for important information
    • Click “Install” and wait for the process to complete
    • This may take several minutes depending on your internet speed and hardware
  3. Configure the Add-on
    • After installation, go to the “Configuration” tab
    • Modify settings as needed (each add-on has different options)
    • Click “Save”
  4. Start the Add-on
    • Go to the “Info” tab
    • Click “Start”
    • Optionally, enable “Start on boot” and “Watchdog” for automatic management
    • Enable “Show in sidebar” for quick access

Updating Add-ons

Automatic Updates

  1. In the add-on’s Info tab, enable “Auto-update”
  2. The add-on will automatically update when new versions are available

Manual Updates

  1. When an update is available, you’ll see an “Update” button in the add-on’s Info tab
  2. Click “Update” to install the latest version
  3. Check the changelog before updating for any breaking changes

Troubleshooting

Repository Not Showing

If the repository doesn’t appear after adding:

  1. Check the URL: Ensure you entered exactly: https://github.com/j0rsa/home-assistant-addons
  2. Reload Supervisor: Settings → System → Hardware → ⋮ → Reload Supervisor
  3. Check Logs: Settings → System → Logs → Select “Supervisor”
  4. Network Issues: Ensure your Home Assistant can access GitHub

Installation Fails

If an add-on fails to install:

  1. Check Architecture: Ensure the add-on supports your hardware architecture
  2. Storage Space: Verify you have sufficient disk space
  3. Check Supervisor Logs: Look for error messages in the Supervisor logs
  4. Network Connectivity: Ensure stable internet connection
  5. Try Again Later: Sometimes Docker Hub rate limits can cause temporary failures

Add-on Won’t Start

If an installed add-on won’t start:

  1. Check Configuration: Review the Configuration tab for any required settings
  2. Port Conflicts: Ensure no other services are using the same ports
  3. Check Add-on Logs: View the Log tab for error messages
  4. Resource Limits: Some add-ons require significant RAM or CPU

Architecture Support

Our add-ons support various architectures. Check compatibility before installation:

  • amd64: Standard Intel/AMD 64-bit processors (most PCs, Intel NUC)
  • aarch64: 64-bit ARM processors (Raspberry Pi 4/5, ODROID)
  • armv7: 32-bit ARM processors (Raspberry Pi 3, older ARM devices)

Getting Help

If you encounter issues:

  1. Check Documentation: Each add-on has a Documentation tab with specific information
  2. GitHub Issues: Report bugs or request features on our GitHub repository
  3. Community Forum: Ask questions in the Home Assistant Community
  4. Logs: Always include relevant logs when reporting issues

Security Considerations

  • API Keys: Keep any API keys or passwords secure
  • Network Exposure: Be cautious when exposing add-ons to the internet
  • Regular Updates: Keep add-ons updated for security patches
  • Backup: Always backup your configuration before major changes
← Back to Home View Add-ons →