RPSync is your personal, privacy-first command center for social media analytics. Run this application locally to collect, visualize, and own your statistics from Instagram, TikTok, Youtube, Bluesky, and more.

• 100% Local & Private: Your data stays on your machine.
• Unified Dashboard: Quickly Visualize your posts on the simple dashboard.
• Data Ownership: Export seamlessly to NocoDB or CSV.
• Free & Open Source: No subscriptions, no hidden fees.

• Docker & Docker Compose
• OpenSSL (Pre-installed on most Linux/WSL systems)
• Windows Users: Install WSL2 first.

The easiest way to get up and running.

1. Run the install script:

   curl -o install.sh https://raw.githubusercontent.com/fluffyriot/rpsync/refs/heads/main/install.sh && sudo chmod +x install.sh && ./install.sh

2. Follow the prompts to configure:

   • Deployment Type (Local vs. Public)
   • IP Address / Domain
   • Secure Keys (Auto-generated)
   • Web Server (Caddy) & HTTPS

3. Access the App: Open the URL provided at the end of the script (e.g., https://192.168.1.50:8443).

Note: For local installations with self-signed certificates, accept the browser security warning ("Advanced" -> "Proceed").

mkdir rpsync && cd rpsync
mkdir -p outputs && sudo chmod 777 outputs

POSTGRES_DB=rpsync-db
POSTGRES_USER=local-user-ctd
POSTGRES_PASSWORD=password123
POSTGRES_PORT=5435
POSTGRES_HOST=db
POSTGRES_SSLMODE=disable

APP_PORT=22347
HTTP_PORT=8081
HTTPS_PORT=8443
GIN_MODE=debug

LOCAL_IP=
DOMAIN_NAME=
TOKEN_ENCRYPTION_KEY= # generate with: openssl rand -base64 32
OAUTH_ENCRYPTION_KEY= # generate with: openssl rand -base64 32
SESSION_KEY=          # generate with: openssl rand -base64 32

version: "3.9"
services:
  db:
    image: postgres:16-alpine
    restart: unless-stopped
    container_name: rpsync_db
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
    volumes:
      - db_data:/var/lib/postgresql/data
    ports:
      - "${POSTGRES_PORT}:5432"

  app:
    image: fluffyriot/rpsync:latest
    restart: unless-stopped
    container_name: rpsync_app
    env_file: .env
    environment:
       HOME: /home/appuser
    depends_on:
      - db
    volumes:
      - ./outputs:/app/outputs
    # ports:
    #   - "${APP_PORT}:${APP_PORT}" # Uncomment for local access

  caddy:
    image: caddy:latest
    container_name: rpsync_caddy
    restart: unless-stopped
    env_file: .env
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./certs:/certs
    ports:
      - "${HTTP_PORT}:${HTTP_PORT}"
      - "${HTTPS_PORT}:${HTTPS_PORT}"
    depends_on:
      - app

  watchtower:
    image: nickfedor/watchtower
    container_name: rpsync_watchtower
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --interval 14400 --cleanup rpsync_app

volumes:
  db_data:

:${HTTP_PORT} {
    redir https://{host}:${HTTPS_PORT}{uri} permanent
}
:${HTTPS_PORT} {
    tls /certs/server.crt /certs/server.key
    reverse_proxy app:${APP_PORT}
}

:${HTTP_PORT} {
    redir https://{host}:${HTTPS_PORT}{uri} permanent
}
${DOMAIN_NAME} {
    tls [email protected]
    reverse_proxy app:${APP_PORT}
}

docker compose up -d

Important Your Instagram account must:

• Be a Business or Creator account
• Be connected to a Facebook Page

Reference:

• https://help.instagram.com/1980623166138346/
• https://www.facebook.com/help/instagram/790156881117411

1. Go to Meta for Developers and create an account: https://developers.facebook.com/apps/

2. Create a new app.

   • Select:

     • Manage Messaging and content on Instagram
     • Manage everything on your Page

3. In the App Dashboard, navigate to Settings → Basic.

4. Copy the App ID and App Secret. You will use them later at the source setup in the app.

5. Open Facebook Login for Business.

   • Under Client OAuth Settings, add the following to Valid OAuth Redirect URIs:

     https://LOCAL_IP:HTTPS_PORT/auth/facebook/callback
     

6. Go to Use Cases, edit the Instagram use case.

7. Under API setup with Facebook Login, add permissions in the Manage content section.

8. In Permissions and Features, enable:

   • Manage insights
   • Manage comments

9. Open Graph Explorer: https://developers.facebook.com/tools/explorer/

10. Click Generate Token, select your Page and Instagram account.

11. Copy and save the numeric Instagram Page ID displayed. You will use them later at the source setup in the app.

1. Create App: Go to my.telegram.org to get API ID and API Hash.
2. Create Bot: Talk to @BotFather to get a Bot Token.

Due to TikTok limitations, to enable TikTok sync you need to deploy the app locally first, connect TikTok as a source, and then use the app to export the cookies JSON file. Then, you can import the cookies JSON file into the cloud deployment.

Sync messages from Discord text channels and threads from Discord forum channels.

1. Go to Discord Developer Portal
2. Click New Application, give it a name, accept ToS, and click Create
3. Navigate to the Bot section in the left sidebar

1. Click Reset Token to generate a new bot token
2. Copy and save the token - you'll need this for RPSync configuration
3. Under Privileged Gateway Intents, enable:
   • Server Members Intent (required for member count/followers)
   • Message Content Intent (required to read message text)

1. Navigate to OAuth2 → URL Generator in the left sidebar
2. Under Scopes, select:
   • bot
3. Under Bot Permissions, select:
   • View Channels (required to see channels)
   • Read Message History (required to fetch messages)
4. Copy the generated URL at the bottom

1. Open the copied URL in your browser
2. Select your Discord server from the dropdown
3. Click Authorize and complete the CAPTCHA
4. Verify the bot appears in your server's member list

1. Enable Developer Mode in Discord:
   • User Settings → App Settings → Advanced → Enable Developer Mode
2. Right-click your server icon → Copy Server ID
3. Right-click each channel you want to sync → Copy Channel ID

When adding a Discord source in RPSync:

• Bot Token: The token from step 2
• Server ID: The server ID from step 5
• Channel IDs: Comma-separated list of channel IDs (e.g., 123456789,987654321)

Supported Channel Types:

• Text Channels: Syncs messages as posts
• Forum Channels: Syncs threads as posts (thread title = content, message count = likes)

Run these commands inside the container or via docker exec:

• Reset Password: ./rpsync --reset-password --username <username>
• Reset 2FA: ./rpsync --reset-2fa --username <username>

• Password Policy: Min 8 characters, must contain uppercase, lowercase, number, and special character.
• 2FA (TOTP): Enable in Settings using Google Authenticator / Authy.
• Passkeys: Biometric login (TouchID/FaceID). Note: Requires public domain deployment.

All platform names, logos, and brands referenced in this project — including but not limited to Instagram, Meta, TikTok, Reddit, YouTube, Google, Discord, Bluesky, Mastodon, Telegram, FurAffinity, e621, Murrtube, FurTrack, BadPups, and NocoDB — are trademarks or registered trademarks of their respective owners. RPSync is not affiliated with, endorsed by, sponsored by, or in any way officially connected to any of these platforms or their parent companies.

Certain features of this software (including web scraping) may violate the Terms of Service of some platforms. By using RPSync, you acknowledge that:

• You are solely responsible for ensuring your use of this software complies with each platform's Terms of Service, API usage policies, and any applicable laws in your jurisdiction.
• The developers of RPSync are not liable for account suspensions, bans, legal action, or any other consequences resulting from your use of this software.
• For platforms that use authenticated session scraping (e.g. TikTok), this tool only accesses data using credentials and cookies that you yourself provide — it does not bypass authentication on your behalf or enable access to data you are not already authorised to view.

This software is provided "as is", without warranty of any kind, express or implied. Use at your own risk. The developers make no guarantees regarding the reliability, legality, or fitness of this software for any particular purpose. See the AGPL-3.0 License for full warranty disclaimer terms.

Contributions are welcome! Please open an issue or submit a PR on GitHub.

• Issues: Report bugs or request features.
• Pull Requests: Submit improvements.