Get OAuth authentication working in 5 minutes.

nself oauth install

nself oauth enable --providers google,github

1. Go to Google Cloud Console
2. Create project → APIs & Services → Credentials
3. Create OAuth client ID (Web application)
4. Add redirect URI: http://localhost:3100/oauth/google/callback
5. Copy Client ID and Client Secret

1. Go to GitHub Settings
2. OAuth Apps → New OAuth App
3. Callback URL: http://localhost:3100/oauth/github/callback
4. Copy Client ID and Client Secret

nself oauth config google \
  --client-id=YOUR_CLIENT_ID \
  --client-secret=YOUR_CLIENT_SECRET

nself oauth config github \
  --client-id=YOUR_CLIENT_ID \
  --client-secret=YOUR_CLIENT_SECRET

nself build
nself start

Visit: http://localhost:3100/oauth/google

You should be redirected to Google login, then back to your frontend with a JWT token.

// Login button
<button onClick={() => {
  window.location.href = 'http://localhost:3100/oauth/google';
}}>
  Sign in with Google
</button>

// Handle callback
useEffect(() => {
  const token = new URLSearchParams(window.location.search).get('token');
  if (token) {
    localStorage.setItem('authToken', token);
    window.location.href = '/dashboard';
  }
}, []);

Your OAuth authentication is now working.

• Complete OAuth Setup Guide
• OAuth CLI Reference
• Security Best Practices

nself oauth enable --providers google

nself oauth config google --client-id=xxx --client-secret=xxx

nself start
docker logs oauth-handlers

nself oauth status
nself oauth test google

Need help? See OAuth Setup Guide for detailed instructions.