Welcome to Linu

Linu is a cross-platform lightweight message push solution designed to solve pain points of traditional push systems like "push-only," weak interaction, and uncontrollable privacy. Comprising a mobile app and a cloud gateway, it provides you with a high-performance, scalable push service capable of End-to-End Encryption (E2EE).

Why Choose Linu?

In today's increasingly popular automation workflows, scripts and AI can help us handle massive tasks. However, at critical decision points, human confirmation and correction are still indispensable.

Linu is born for this. It is not just a carrier of messages, but a Human-in-the-loop Interface in automation workflows. Wherever you are, you can receive task requests via Linu and make decisions directly by clicking buttons or replying to messages, allowing workflows to flow seamlessly.

1. True Two-Way Interaction

Linu introduces a powerful Webhook mechanism that makes notifications actionable:

Action Buttons: Trigger remote operations directly by clicking buttons (e.g., "Deploy", "Restart", "Approve") on the notification bar or message card.
Inline Reply: Reply to messages directly like chatting, with content sent back to your service in real-time, perfect for interfacing with ChatOps or AI assistants.

2. Privacy-First Design

We understand the importance of data privacy, so Linu guarantees security from the architectural level:

End-to-End Encryption (E2EE): Messages are encrypted with a public key at the sender and decrypted only with a private key on your phone. Even if the server is compromised, attackers cannot obtain the original message content.
Data Sovereignty: In addition to the out-of-the-box official service, we also provide a complete Self-hosted solution, giving you complete control over your data.

3. Rich Message Expressiveness

Say goodbye to boring plain text. Linu supports:

Rich Media: Embedded images, videos, and even real-time preview streams.
Message Grouping: Automatically aggregate messages by group_id to form a clear timeline view.

Technical Architecture

Linu adopts a classic Client-Server architecture but is deeply optimized for security.

Linu Server (Rust):
- Developed based on Rust, with extremely low memory footprint, easily supporting tens of thousands of concurrent connections on a single machine.
- Core responsibilities: Authentication, message routing, FCM/APNs channel bridging, WAL persistence to avoid message loss.
- Provides RESTful APIs for easy integration into any programming language.
Linu Client (Flutter):
- Cross-platform support for iOS and Android.
- Core responsibilities: Local key generation and management, message decryption and display, initiating interactive actions.

Quick Start

Start your Linu journey in just three steps.

Step 1: Download the App

Go to the App Store or Google Play to download the Linu client.

Step 2: Get Device Token

Open the App and complete the initial setup.
Go to Settings > Device Info.
Copy your Device Token.

Step 3: Send Your First Message

Use a simple cURL command to send a request to the official gateway:

curl -X POST https://api.linu.app/v1/push \
  -H "Content-Type: application/json" \
  -d '{
    "ios": ["YOUR_DEVICE_TOKEN"],
    "message": {
      "title": "Hello Linu",
      "text": "This is a test message from Linu",
      "group_id": "test"
    },
    "options": {
      "priority": "normal"
    }
  }'

Note: The official service is currently completely free. You can directly call the API for testing and use.

Advanced Usage

Server Monitoring: Combine with scripts to push alerts directly to your phone, accompanied by a "Restart Service" button.
Human-in-the-loop: Build an AI assistant with LLM, review AI-generated content on your phone, and publish with one click.

For Geeks: Self-hosted

If you have extremely high requirements for data privacy or wish to run in an intranet environment, Linu supports self-hosted deployment.

For detailed deployment guides, please refer to: Self-hosted Deployment Docs