Quickstart

See Bosca in Action

The best way to understand Bosca is to try it. This guide will help you set up a local version of Bosca so you can explore its features firsthand.

1. Launch with Docker

The fastest way to get started is using Docker. This will set up everything Bosca needs to run on your computer.

git clone git@github.com:sowers-io/bosca-framework.git
cd bosca
docker compose up -d
./gradlew :backend:servers:bosca-server:run

2. Explore the Dashboard

Once the server is running, you can log in to the Bosca Administration panel. This is where you'll manage your content, view analytics, and configure your platform.

• Administration URL: http://127.0.0.1:8080/login
• Default Username: admin
• Default Password: password

3. Built for Developers

If you want to build on top of Bosca, we've made it incredibly easy. You can interact with all your data through our modern GraphQL API or extend the platform with our modular architecture.

• API Explorer: http://127.0.0.1:8080/graphiql

You can also run our Nuxt-based administration interface for a fully customizable experience:

cd web/administration
pnpm install
pnpm dev

What's Next?

Now that you're in, it's time to start organizing your content:

• Organize with Collections: Group your content in ways that make sense for your team.
• Add Rich Metadata: Make your content easier to find and understand.
• Analyze Your Impact: See how your audience is interacting with your content.

For more technical details on deployment, visit our Deployment Guide.