Getting started with Operous

Create an account

Create a free account on https://app.operous.dev/login and click the Get started with GitHub button.

Only GitHub accounts are currently supported. Make contact if you need another account provider.

Registering a server

The primary entity for Operous is a ssh server. It doesn’t matter the type it might be: physical or virtual, on-premise or public cloud. It must have a reachable SSH service over the Internet for Operous to connect to it.

After the account creation, the onboard process requires the registration of at least one server.

Only Ubuntu 18.04 and 20.04 are currently supported.

Copy the command shown on the interface and execute it on a server.

The script shows an output similar to the example below after a successful registration:

[email protected]:~$ curl -fsS https://app.operous.dev/i/installer.sh | sudo sh -s WBw98UVdPrN2
[1/3] ✔ This server is supported
[2/3] ✔ SSHD successfully configured
[3/3] ✔ Operous Test Runner has successfully connected to this server

Well done!

This server was sucessfully registered and is ready to be tested!

Operous has started a Test Run. Check the results on the link below:

https://app.operous.dev/servers/3CkVRAgGrBQ0sdRg/tests/1

Done in 39336 ms

Operous has successfully registered the server.

A ssh test runs automatically after the registration and in a few seconds the results appear on the provided link at the end.

Learn more about the Registration script.

Enter the continuous improvement loop

With the server registered it’s possible to continuously improve it. Start a ssh test, run it, fix the issues detected until it passes.

Starting an ssh test

On the servers list page, click the Start SSH Test button to test the server.

test it
Figure 1: Test button

Run it

The SSH Test Run begins after clicking Start SSH Test. A page informing that the Test Run is active shows up. It should take no more than a minute.

testing
Figure 2: Wait for the results

Make it pass

When the Test Run finishes, a list of the tested items shows which items passed and which failed.

A failed test has a short description explaining why it failed. Click the more info button to open the documentation page that explains more details about what is being tested, why it’s tested, and how to fix it.

fix it
Figure 3: A failed test

Repeat

As time passes, the Operous team updates the SSH test according to newly discovered vulnerabilities to detect these new scenarios and the correct way to deal with them.

To ensure you’re up-to-date with all points the SSH test verifies in your server, check the ssh test suite.