vinc/oauthd-instance repository overview

Docker container for oauthd⁠

Quick-setup:

Launch a Redis container⁠

docker run -d --name redis -p 6379:6379 dockerfile/redis

Get your VM's Host interface IP address (or domain). Then launch a docker instance of oauthd with the following command:

docker run -p 443:443 -p 6284:6284 -e oauthd_host_url=http://YOUR_IP:6284 -d --link redis:redis vinc/oauthd-instance

Once the instance server is started, you can access the web interface to create your first app and configure its API providers.

Go to the following url in your favorite browser: http://YOUR_IP:6284/

When presented with the /login page for the first time, just sign up. (remember your login credential for next sign in).

Common issue: If you get stuck on the /login page, it might be because your docker container is out of sync with your machine. Thus, the expiration timestamp is invalid and cause redirection to the login page. Relevant stack overflow post⁠

Other commands:

Launching the container with tty interactive mode:

docker run -i -t --entrypoint=/bin/bash -p 443:443 -p 6284:6284 -e oauthd_host_url=http://YOUR_IP:6284 --link redis:redis vinc/oauthd-instance

Getting into the container while it is running: With docker 1.3, there is a new command docker exec⁠. This allows you to enter a running docker:

docker exec -it "id of running container" bash