Skip to content

Latest commit

 

History

History
38 lines (24 loc) · 1.44 KB

README.md

File metadata and controls

38 lines (24 loc) · 1.44 KB

SpongeAuth

build Coverage Status

An authentication portal for shared user accounts between Sponge services.

Originally written in Play, but ported to Django and made more robust with more extensive testing.

Developing

You'll need:

  • A working Docker install (for Linux, install from your package manager; for macOS, use Docker for Mac; for Windows, use Docker for Windows)
  • docker-compose (for Linux, install from your package manager; for macOS/Windows, these should be included with Docker for Mac/Windows)

Run

docker-compose up

and wait for a bit. When you see

su -c '/env/bin/python spongeauth/manage.py runserver 0.0.0.0:8000' spongeauth

then you should be able to visit http://localhost:8000 and have a working SpongeAuth install.

If you need an administrator account, you should be able to run:

docker-compose run app /env/bin/python spongeauth/manage.py createsuperuser

and follow the prompts to get an administrator account. This must be done after the up command above.