How Can We Help?

Installing SageTea Cloud for Linux

You are here:
< Back

SageTea Cloud is available for Ubuntu Linux. Here are the steps to install it.


The optimal configuration for your Ubuntu Linux box is to set it up with a fully qualified domain name.

  1. Go to this link;
  2. Download the file sageteacloud.deb to an Ubuntu Linux system;
  3. Start a terminal by running the command “Xterm“;
  4. Go to the directory that has the file sageteacloud[latest version].deb;
  5. From the command line run the command: “sudo dpkg -i sageteacloud[latest version].deb“. Run “sudo apt-get install -f” if the dpkg command gives error messages about dependencies.

Once you have completed these steps, you will have SageTeaCloud and a default portal installed on your Ubuntu server.

SageTea Cloud

SageTea Cloud is installed in the directory  /usr/bin/sageteacloud and mainly consists of three parts:

  1. visual: Smalltalk VM engine;
  2. Application Server image;
  3. Web Server image;

Default Portal

A web portal with the default DLC (Downloadable Content) will be installed to the directory /home/sageteaadmin

-rw-r--r-- 1 sageteaadmin sageteaadmin  806 Jun 13 15:00 portal.conf
drwxr-xr-x 3 sageteaadmin sageteaadmin 4096 Jun 12 15:48 server
drwxrwxr-x 3 sageteaadmin sageteaadmin 4096 Jun 12 15:38 webserver
  • portal.conf contains the complete configuration for the portal;
  • server subdirectory holds the DLC file that the user has developed;
  • webserver subdirectory contains the error log of the Web Server.

By default, the SageTea Cloud Application Server runs on tcp 7000 port and the Web Server runs on tcp 7001 port. You can change the default port config in portal.conf.

Now you can connect to SageTea Cloud using TextToSoftware.

The SageTea Cloud’s Web Server will be located at http://[your machine IP address]:7001

Runs as a Service

SageTeaCloud runs as a Linux service as a daemon (SystemD).

The service names for the Application Server and the Web Server are sageteacloud  and sageteacloudweb, respectively.

The four commands below have to be run in the specified order, for a cloud to be launched. The first two launch the Application Server, while the last two launch the Web Server.

sudo systemctl start/stop/restart/enable/disable sageteacloud@sageteaadmin
sudo systemctl start/stop/restart/enable/disable sageteacloudweb@sageteaadmin            
sudo journalctl -n 100 -f -u sageteacloud@sageteaadmin
sudo journalctl -n 100 -f -u sageteacloudweb@sageteaadmin

The indication that the Application Server was launched is the journal control message:

[Date] [Time] [Machine name] visual[[PID]]: Network server started: SAGETEAOpenTalkServer

After the Application Server has been launched, the above two last commands will make the following message to appear:

[Date] [Time] [Machine name] visual[[PID]]: Launched Seaside on: http://[Your machine name]:7001/[Application name]

This completes the process of launching a cloud manually, using Linux services.

By using the capability of Linux services, any cloud can be stopped or restarted, by using the options stop and restart on the above services, respectively. At any time, a cloud can be programmed to be launched automatically when the Linux machine is booted, by using the option enable. This option is set by default when installing a SageTea Cloud. This feature can be disabled with the option disable.

You can make your SageTea Cloud into a private cloud that uses your server’s local IP address by running the command “StartPrivateCloud“. Alternately you can make your cloud public by running the command “StartPublicCloud” from the command line.

Table of Contents