PropelAuth BYO has only one dependency: a Postgres database. For developing locally, we’re going to use docker compose to run both the database and the PropelAuth BYO sidecar.

1. Clone the repo with config files and docker compose setup:

   git clone git@github.com:PropelAuth/byo-config-template.git

   • Directorybyo-config-template/

     • .env.example
     • compose.yaml
     • Directoryconfigs/

       • sso_config.jsonc
       • scim_config.jsonc
       • session_config.jsonc
       • … and other configs

2. Copy the .env.example file to a new .env file and update the BYO_LICENSE_KEY variable with your PropelAuth BYO license key. You can get a license key by going to the PropelAuth Dashboard.

   cp .env.example .env

   .env

   BYO_LICENSE_KEY="pa_..."
   INITIAL_OWNER_USERNAME="root"

3. Run docker compose to start the Postgres database and PropelAuth BYO sidecar:

   docker compose -f compose.yaml up -d

   This will start both the Postgres database and the PropelAuth BYO sidecar. The sidecar will automatically connect to the database and run any necessary migrations.

4. To verify everything is running correctly, navigate to http://localhost:2884 and you should see a login page:

   

5. Log in with the INITIAL_OWNER_USERNAME (from your .env file, default is root) and the password thispasswordistemporary. You will be prompted to change your password after logging in.