Self-Hosting

By default, sfeed uses the hosted auth proxy at auth.sfeed.dev so you don't need to register a Facebook App. If you prefer to keep everything local, you can self-host.

When to self-host

• You don't want your tokens stored on our servers
• You want to use your own Facebook App (different rate limits, permissions)
• You're behind a firewall that blocks auth.sfeed.dev

Setup

1. Create a Facebook App

1. Go to developers.facebook.com/apps
2. Create a new app (type: Business)
3. Add the "Facebook Login" product
4. In Facebook Login > Settings, add redirect URI: http://127.0.0.1:8739/callback
5. Also enable "Manage messaging & content on Instagram" and "Manage everything on your Page" use cases
6. Copy your App ID and App Secret from Settings > Basic

2. Save credentials

Create ~/.sfeed/.env:

SFEED_FB_APP_ID=your_app_id
SFEED_FB_APP_SECRET=your_app_secret

3. Authenticate

sfeed auth facebook

When SFEED_FB_APP_ID is set, sfeed uses direct OAuth instead of the hosted proxy. All tokens stay local.

Scheduling in self-hosted mode

Cloud scheduling is not available in self-hosted mode (no tokens on the server). Use the local daemon instead:

sfeed daemon

This runs in the foreground and checks ~/.sfeed/schedule.json every 30 seconds.

Facebook App Review

Apps in Development Mode only work for users with a role on the app (Admin, Developer, Tester). This is fine for personal use. If you want others to use your app, you'll need to submit for Facebook App Review.

Back to Docs