---

2.2 The five-minute path ¶

The full install lives in Installation. This is the abbreviated form.

1. Clone the repo.

   git clone https://github.com/blakemcbride/Ownsona.git
   cd Ownsona
   

2. Provision the database.

   sudo -u postgres createuser --pwprompt ownsona
   sudo -u postgres createdb -O ownsona ownsona
   sql/setup_db.sh '<the-password-you-just-set>'
   

   This creates the schema, installs the pgvector and pg_trgm extensions, and grants the ownsona role the privileges the auto-migrator needs.

3. Configure the server.

   cp src/main/backend/application.ini.example src/main/backend/application.ini
   $EDITOR src/main/backend/application.ini
   

   At minimum, set DatabasePassword, OWNSONA_API_TOKEN (any long random string), and EMBEDDING_API_KEY.

4. Build and deploy.

   ./bld -v build
   ./bld war
   sudo cp work/Kiss.war /home/ownsona/tomcat/webapps/ROOT.war
   

   (See Installation for how to set up the ownsona system user and the ownsona.service systemd unit.)

5. Smoke-test the live endpoint.

   OWNSONA_API_TOKEN=<your-token> sql/smoke_test.sh https://your.host/mcp
   

   A successful smoke test exercises every MCP tool against the live server and prints OK for each.