Symfony user storage system with oauth2 support

dev-master 2018-01-27 14:50 UTC

This package is auto-updated.

Last update: 2022-09-10 22:52:38 UTC



Storage system for users with oauth2 support, written in Symfony >= 3.4/4.0 with FOSOAuth, FOSUser and EasyAdmin.


Flock is a Symfony project, not a bundle. To install it, create a new project with composer:

composer create-project andythorne/flock flock
cd flock

With the incoming release of Symfony Flex, this will be moved to a pack rather than a project.

Running With Docker

Flock comes with an example Docker container setup using:

To get started, run:

docker-compose up -d

Docker will expose the app over the external network flock, which your can link to.


Public Endpoints

Flock uses the standard FOSUser endpoints for user registration, login and profile management.

See for documentation for extending flock's FOSUser implementation


Flock uses EasyAdmin to provide an admin interface for managing users and OAuth clients. Create a super admin user (./bin/console fos:user:create <username> <email> <password> --super-admin) and head to /admin.


In order to use OAuth2, you first need to create an OAuth Client. Head to /admin and create a new Client, and copy the generated public id and secret into your app's OAuth Client.

Endpoint Description
/oauth/v2/token Token
/oauth/v2/auth Authentication
/api/user User Data

For a guide on how to use HWIOAuthBundle in your app to authenticate with flock, see


Written by: