Research

Joining a network without an IT department.

We watched small firms set up CalyOS Server on their own. Here is where they got stuck, and what the setup does differently now because of it.

Talk to our team

The short version

Setup should not need a specialist.

Most of the firms we work with have no IT department. When they buy a server, someone on the team plugs it in on a Friday and hopes it has joined the office by Monday. We wanted to know exactly where that hope runs out. So we sat with small firms as they set up CalyOS Server for the first time, took notes on every pause, and rebuilt the parts that made people stop.

What we found

The three places people stopped.

Imagery in production

Naming the machine

The first screen asked for a hostname, and the room went quiet.

Half the people we watched had never met the word hostname, and the field sat there blinking at them. Some typed their company name with spaces and got an error they could not read. Others closed the laptop and waited for a braver colleague. We replaced the field with a plain question: what should we call this computer? Spaces are fine now, and the machine works out the technical name on its own, behind the scenes.

Imagery in production

Knowing it actually worked

People finished the setup and still could not tell if the server was on the network.

The old wizard ended on a summary full of green ticks and technical labels. Nobody trusted it. Several firms called our support line to ask a question we had never answered on screen: is it done? So the last step now says it in words. It names the desks that can already reach the server and tells you the one thing to try next. If something is not ready, it says which thing, in the order to fix it.

Imagery in production

Adding the first person

Creating the first account felt like it might break everything.

Adding a user meant a form with roles, groups and permissions, and people froze rather than pick the wrong one. The fear was fair. On most systems a wrong choice here is hard to undo. Now the first account is one line: a name and an email. Sensible access comes with it, and anything you set can be changed later without starting over. Nothing on this screen is permanent.

Closer look

The screen we rebuilt first.

The opening step used to ask for a hostname. Now it asks what to call the computer, in the words a person would use, and quietly handles the rest.

Imagery in production

The redesigned first step of CalyOS Server setup.

How it works now

On the network in three steps.

The rebuilt setup asks three plain questions and handles the rest itself. Nobody we watched needed a glossary or a phone call to finish it.

Name the computer

Give it a name a person would recognise, like Front Office or Workshop. CalyOS turns that into the technical name the network needs, and you never have to see that part.
Point it at the office

Tell it which network it belongs to and it finds the other machines on its own. When it is ready, it says so in plain words and names the desks that can already reach it.
Add the first person

One line, a name and an email, sets up the first account with sensible access. Everyone else joins the same way, and anything here can be changed later.

Before and after

Two habits we broke.

Imagery in production

Jargon

We stopped asking for words people never use

Hostname, subnet, directory. If a step needed a glossary, we rewrote the step until it needed none. The technical work still happens. It just happens out of sight.

Read our commitments

Imagery in production

Doubt

We stopped ending on a shrug

Every setup now finishes with a clear answer: it worked, here is who can reach it, here is what to try. When something is not ready, the screen says which thing and what to do about it.

Talk to our team

“If a setup step needs a manual, the step is the thing that is broken, not the person reading it.”

The Calyraen research desk

What it means for you

A server you can set up yourself.

The findings from this study ship in every copy of CalyOS Server.

Plain

Questions, not fields

Every step asks something a person can answer, and handles the technical part on its own.

See our servers

Sure

You know when it worked

Setup ends with a clear answer and the one thing to try next, in words rather than ticks.

Safe

Nothing you pick is final

The first account and its access can be changed later. A wrong guess never means starting over.

Keep reading

More from the research desk.

The full index, newest first. Notes on what we build, test and learn.

Back to the index Talk to our team

Joining a network without an IT department.

Setup should not need a specialist.

Naming the machine

Knowing it actually worked

Adding the first person

Name the computer

Point it at the office

Add the first person

We stopped asking for words people never use

We stopped ending on a shrug

Questions, not fields

You know when it worked

Nothing you pick is final

More from the research desk.