Walkthrough
Once you've cloned all repositories, this page walks you through running the stack for the first time and verifying everything is working.
1. Start the base stack
cd Quickstart
make base
make base brings up CoreAPI with its required infrastructure services — Postgres, Redis, and SeaweedFS. No admin apps or auth services needed for this walkthrough.
When it's ready, CoreAPI will be running at http://localhost:3000.
2. Verify seed data and the media API
On startup, CoreAPI automatically runs migrations and seeds initial data. To confirm it's working, hit the media endpoint:
curl http://localhost:3000/api/v1/media
You should get back a JSON response with seeded media records. If you get an empty array [] that's fine too — it means the database is up and the domain is responding.
3. Try the media UI
CoreAPI serves two built-in HTML pages for testing the media domain without needing the admin app:
| Page | URL |
|---|---|
| Upload media | http://localhost:3000/upload |
| List media | http://localhost:3000/ |
Open media-upload.html to upload a test file, then check media-list.html to confirm it appears. This exercises the full media flow — upload to SeaweedFS, record written to Postgres, served back through CoreAPI.
Next steps
Once the base stack is confirmed working, see Make Targets for other targets that bring up the full platform including admin apps and auth.