DOCS / GUIDES

Your first coop: workspaces explained

Understand how coops, flocks, and hens fit together before you scale.

Beginner10 min read
Before you beginYou need the cluck CLI, a Pollosoft account, and a coop to work in. No prior experience required. Curiosity and a mild fondness for chickens are helpful.

Overview

Understand how coops, flocks, and hens fit together before you scale. The whole thing takes about 10 minutes, and the commands below are the ones you will use along the way.

$ cluck coop create staging --region eu-west-1
$ cluck coop list
$ cluck coop use staging

Steps

  1. Coops are workspaces. A coop holds your services, secrets, and members. Everything you deploy lives inside exactly one coop.
  2. Flocks are groups. A flock is a set of hens (users) with shared permissions. Put people in flocks, not individually, to avoid an unmanageable pecking order.
  3. Regions. Pick a region close to your users. You can replicate across coops later, but a coop lives in one place, like a chicken.
  4. Switching coops. Use cluck coop use to switch. The active coop shows in your prompt as a tiny egg.

Commands used

Keep going

Stuck? Check the error codes, the FAQ, or the glossary.