Tobogganing

Get started with Tobogganing

Stand up the Tobogganing core API and headend locally to explore certificate-based Zero Trust access.

  1. 1. Clone the repo

    git clone https://github.com/penguintechinc/tobogganing.git
cd tobogganing

  2. 2. Configure environment

    Copy the example environment file and set your own database and JWT secrets before starting any services.

    cp deploy/docker-compose/.env.example deploy/docker-compose/.env

  3. 3. Start the stack

    Bring up the core API and headend with Docker Compose.

    cd deploy/docker-compose
docker-compose -f docker-compose.yml up -d

  4. 4. Access the web portal

    Open the portal at http://localhost:8000 and log in with the admin account created on first startup — check the core API container logs for the generated password, and change it immediately.

  5. 5. Install a client

    Issue an API key from the portal, then connect a native or headless client.

    ./tobogganing-client init --manager-url http://localhost:8000 --api-key YOUR_API_KEY
./tobogganing-client gui

More resources