Control

Controlling your serverlet and the software running on it.

Controlling the serverlet

Power on, restart, and shut down. These actions can only be performed from the administration panel, on the serverlet’s card.

A restart is equivalent to a forced shutdown and power-on, which interrupts your applications and may cause loss of unsaved data or database corruption. We recommend only doing this when necessary β€” if possible, properly shut down your other applications first. After performing one of these actions, wait at least 60 seconds before performing another.

A powered-off serverlet is billed the same as a running one, because we still reserve the necessary resources for it on our end.

Controlling software

Pre-installed and custom software on the serverlet can be controlled in two ways. We don’t recommend using both control methods at the same time β€” Administration doesn’t show real-time changes made to the serverlet via SSH.

Disabled software doesn’t use any resources and isn’t started on boot. Enabled software is automatically started when the serverlet boots. Most software is disabled right after a serverlet is created. The first time certain software (MariaDB, PostgreSQL, MongoDB…) is enabled, it reserves disk space that remains allocated until it’s deleted.

Every additional piece of software you enable and run uses more of the serverlet’s resources. We recommend only enabling the software you actually need to run your application.

Administration

You can control software from Administration, on the Software tab. There you’ll find all the software on the serverlet managed by runit. You can learn how to add your own software in the runit chapter.

ActionDescription
ReloadThe application reloads its configuration β€” a restart without downtime, for applications that support it.
RestartA hard restart with downtime
StopStops the application
StartStarts the application

Terminal

Tip: Only the applet user can control applications.

You can also comfortably control the serverlet from the command line over SSH. See the SSH chapter for how to connect. We’ve prepared a simple app command for controlling the serverlet:

plaintext
Futrou Serverlet Manager
Usage: app {start|restart|reload|stop|status|disable|enable} {app_name}
Usage: app list

Usage looks like this:

plaintext
$ app {command} {application name}

For example:

plaintext
$ app status lsws

To list applications:

plaintext
$ app list

System apps:    runit
Registered user apps:    lsws    mariadb    moje-aplikace    mongodb    redis

Last updated