Tailscale ACAP for Axis Cameras

🌐 Visit the Homepage

This repository provides an ACAP package that installs the Tailscale VPN client on Axis cameras.

• ✅ Secure remote access to cameras
• ✅ Easy to install via EAP package
• ✅ Works on Axis OS 12+ (non-root version)
• ✅ Based on WireGuard VPN technology

Disclaimer: This is an independent, community-developed ACAP package and is not an official Axis Communications product. It was developed entirely on personal time and is not affiliated with, endorsed by, or supported by Axis Communications AB. Use it at your own risk. For official Axis software, visit axis.com

Tailscale Notice: Tailscale is a product of Tailscale Inc. This package independently redistributes the Tailscale binaries under the BSD 3-Clause License and is not affiliated with, endorsed by, or supported by Tailscale Inc. For the official Tailscale client, visit tailscale.com.

---

📑 Table of Contents

• 📥 Installation
• 🚀 Usage
• 🔄 Updating Tailscale
• 🧪 Testers Needed
• 🎉 Good News
• 🎯 Purpose
• 🔗 Useful Links
• 🖥️ Compatibility
• ⭐ Star History
• 💖 Support

---

📥 Installation

Get the prebuilt .eap file from the Releases page.

1. Log into your Axis camera.
2. Go to Apps → Add App.
3. Upload the .eap file.

Once installed:

• Start the app.
• Click Open to view logs and get your Tailscale authentication URL.
• On uninstall, all changes/files are removed.

⚠️ You’ll need a Tailscale account to authenticate.

---

🚀 Usage

• Runs a startup script to set permissions and launch Tailscale.
• View logs via the Open button in the app.
• Authenticate using the provided URL.

---

🔄 Updating Tailscale

• New .eap files are auto-built and released weekly (if a new Tailscale version is available).
• To update, simply install the new .eap over the existing one.

Manual update (advanced)

Replace the binaries in the lib/ folder:

• tailscale
• tailscaled

Download the latest versions: Tailscale static builds

Build locally

From the main directory of the version you want (arm / aarch64):

docker build --tag <package_name> .
docker cp $(docker create <package_name>):/opt/app ./build

---

🧪 Testers Needed

A new custom version is available:

• Allows setting a custom server and auth key (for Headscale).
• Go to Settings (⋮ → Settings) to add your details.

Please give it a try and share your feedback!

---

🎉 Good News

Tailscale ACAP can now run without root privileges, making it compatible with Axis OS 12+.

• Runs in user space networking mode.

For full networking features, use the ROOT version on Axis OS < 12.

---

🎯 Purpose

Adding a VPN client directly to the camera enables:

• Secure remote access without additional hardware or complex network configuration.
• Easy setup through Tailscale’s lightweight WireGuard-based tunnel.

🔗 Learn more: How Tailscale Works

---

🔗 Useful Links

• Tailscale
• Tailscale GitHub
• WireGuard
• Axis Communications

---

🖥️ Compatibility

The Tailscale ACAP is compatible with Axis cameras with ARM and AARCH64-based SoCs.

You can verify your device details using the following command:

curl --anyauth "*" -u <username>:<password> <device_ip>/axis-cgi/basicdeviceinfo.cgi --data '{"apiVersion":"1.0","context":"Client defined request ID","method":"getAllProperties"}'

Replace <device_ip>, <username>, and <password> with your device credentials.
Enclose your password in quotes ' ' if it contains special characters.

---

⭐ Star History

---

💖 Support

If you like this project and want to support my work:
👉 Sponsor Me