Getting started with Cariosan Cloud

Cariosan Cloud is the managed offering at dashboard.cariosan.com. You sign up, your workspace is provisioned automatically, and your API credentials are waiting in the dashboard. Skip the Docker setup entirely.

Who Cariosan Cloud is for

• Startups that want chat without ops — no Docker, no Postgres, no Redis to manage.
• Teams piloting Cariosan — sandbox an integration in a few minutes, decide later whether to self-host.
• Indonesian-first products — the managed instance is colocated for low Southeast Asia latency.

The flow

go get github.com/cariosan/cariosan-go

package main
 
import (
    "context"
    "fmt"
 
    cariosan "github.com/cariosan/cariosan-go"
)
 
func main() {
    ctx := context.Background()
    client := cariosan.NewClient(cariosan.Config{
        BaseURL:   "https://api.cariosan.com",
        APIKey:    "pk_live_...",   // from dashboard
        APISecret: "sk_live_...",   // from dashboard
    })
 
    // 1. Create two users.
    alice, _ := client.Users.Upsert(ctx, &cariosan.UserUpsert{
        ExternalID: "alice", Name: "Alice",
    })
    bob, _ := client.Users.Upsert(ctx, &cariosan.UserUpsert{
        ExternalID: "bob", Name: "Bob",
    })
 
    // 2. Create a channel between them.
    channel, _ := client.Channels.CreateDirect(ctx, alice.ID, bob.ID)
 
    // 3. Send a message as Alice.
    msg, _ := client.Messages.Send(ctx, &cariosan.MessageSend{
        ChannelID: channel.ID,
        SenderID:  alice.ID,
        Text:      "Hello from Cariosan Cloud!",
    })
 
    fmt.Println("sent:", msg.ID)
}

npm install @cariosan/react

What you get on Cariosan Cloud

Free tier limits

Phase A free tier defaults — per workspace:

• 1,000 messages per day
• 100 concurrent WebSocket connections (peak)
• 100 attachment uploads / month
• 1 GB total attachment storage
• Inactive workspaces purged after 30 days of zero activity

These match the staging droplet capacity. Higher tiers ship with billing.

When you outgrow Cloud

If you cross the free-tier limits before paid tiers are available, or you need data residency that Cariosan Cloud's region doesn't satisfy, self-host with the same Docker image that runs in production:

docker pull ghcr.io/cariosan/server:latest

See Pulling from GHCR for image tags + Docker Compose.

Next steps

• Cariosan Cloud API keys — api_key vs api_secret, rotation, secret hygiene
• TypeScript client SDK
• React SDK
• Webhooks guide — receive events for messages, channel changes, member updates