Creating And Launching A Cillers System

Make sure that OrbStack (MacOS users) or Docker Desktop (Linux/Windows users) is running. The pt run stack command will just wait for it to start otherwise.

Create and launch your Cillers system by running the following commands.

cillers new my-system
cd my-system
pt run stack

You will now see the Polytope Container Runtime UI.

Just like in any operating system, some processes run to completion and some should be kept running. You should expect that the following steps should continue to be in the "Running" state: app-api, couchbase, curity, curity-db, kafka-connect, oauth-agent, kong, redpanda, redpanda-console and web-app.

Use the guide at the bottom of the Polytope UI to navigate. You will find the Polytope UI to be incredibly helpful and powerful.

The start up will take a few minutes extra during the first startup of your system, due to downloads of Docker containers and package installations. The first startup run takes around 5 to 10 minutes.

Attention! If you are on a slow network, you may have to restart the "pt run stack" command to get the initialization to complete.

When the system is fully initialized, you have a super scalable, reliable, secure and cost-effective system infrastructure that can easily be scaled up to serving 100 million requests per second running on your computer. All you need to do now is to add the specific logic that you want for your system. We will soon also make it easy to push your system to production.

Getting Started With Cillers Should Be Trouble Free.

Please reach out for support on our Discord server if you run into any issues.

You can also use our Trouble Shooting Guide.

Web Frontend

Our sample frontend app is located at: http://localhost:8080/. Click the 'Login' link and you will be redirected to a standard Curity login form. Click the "Create account" link under the form.

When logged in you get a form to add products. Test adding a product.

Now, open the Couchbase admin web UI to view the product that you created in the db.

Couchbase Admin Web UI

Your Couchbase Admin Web UI is located at: http://localhost:8091/. The default username is "admin" and your password is "password".

Click the "Documents" link in the left pane and select "products" in the right-most drop-down under "Keyspace". The product that you added should be in the results.

Now, let's try adding a product through our event streaming service, Redpanda.

Redpanda Admin Web UI

Your Redpanda Admin Web UI is located at: http://localhost:8079/.

Click on "Topics" in the left pane, and then on "products" in the topics list.

Click "Actions" and select "Produce Record".

Type anything in the "Key" textarea.

Select "JSON" as the type and add the product as follows:

Click "Produce" at the bottom of the form. Then you can see that the product has been automatically created in the Couchbase "products" collection. And, that it shows up in the list of products the web frontend.

Now, let's add a product using the API Exploration UI, Kong Insomnia.

Kong Insomnia API Exploration UI

Open the Kong Insomnia application. Click the "Create" button, select "Import.

Click "Url" and paste the following URL:

Now, let's add a product. Click "Add Product" in the left pane and click "Send". Insomnia should open up a Curity login pop-up for you. You can use the username and password that you created for the web frontend. You should get a green 200 OK response. The product should now show up in the web frontend.

Now, you are ready to move on to make some changes to the system.

Web UI Reference

When the system has fully initialized you will be able to reach the following web UIs.

Web UIURLCredentials

Web frontend

Create a new user in the Curity UI that you are redirected to when clicking login.

Curity Admin

Username: admin Password: password


Username: admin Password: password



Last updated