Install On Linux

Top  Previous  Next

The Linux installation process involves a few steps with the command line.  You should be the superuser (root) to perform the installation.

 

The same procedure is used for new installations and updating an existing installation.

 

Download https://cirrusprint.com/download/cp30s.linux.zip, which contains cp30s.install.sh and cp30s.linux.tar.gz
 

Extract the two files to a working directory, such as /tmp.  You can use the Linux unzip program, or else extract them on another system and copy the files to the CirrusPrint Linux system.  Note if you use ftp to copy the files, be sure to use binary mode.
 

Run ./cp30s.install.sh, which will prompt for a directory to install CirrusPrint into, the default is /opt/cp30s or wherever a current installation is found.  If this is a new installation, the directory chosen must be new or empty.  The installer will stop and start CirrusPrint during the install process.
 

Port selection is important, as CirrusPrint uses a private web server for browser access.  If CirrusPrint is on a dedicated machine without any other web services, you can use standard ports (http port 80, https port 443).  Otherwise you can choose the alternate ports http on 27082 and https on 27083.  Any other configuration requires manual editing of config.ini.
 

Once the installed, the setup.sh script is run, which will prompt for license acceptance and port selection, then

 

oCreate the cp30s user

oAssign permissions and ownership for the cp30s user to the installation directory

oCreate a processor-specific (Intel/AMD or ARM) executable cp30s.http

oConfigure either systemd or init.d service service scripts, using the name cp30s

oCreate the /usr/bin/cp30s management script

 

Updates

 

You can use the same procedure to update an existing installation.  Just install on top of the original location.  Updates can also be performed using the following commands as root or sudo:

 

 cp30s -update  (prompts before updating)

 cp30s -updatenow  (immediate update)

 

 

Operation

 

Use the following simple options as root or sudo to start and stop the server:

 

cp30s start

cp30s stop

cp30s restart

 

Once installed and started, you can access the server with a web browser, such as Chrome, Edge, or Firefox.  By default, the server listens for http connections on either port 80 or 27082, and https connections on 443 or 27083.  Http connections are only accepted from local network addresses: 127.0.0.1, 10.0.0.0/8, 172.16.0.0/12, or 192.168.0.0/16 ranges.  Https connections, initially served with a self-signed certificate, are available from anywhere.  Be sure the system's firewall allows connections to these ports.

 

For example, if the server's LAN address is 192.168.1.99, and the server is listening on ports 27082 and 27083, use one of these URLs:

 

http://192.168.1.99:27082  

 

https://192.168.1.99:27083

 

The default login is admin, with a random password.  This login should be modified.  Note that if there is no administrative user found when the server starts, this default admin user will be created.

 

To view the current password for the admin user:

 

sudo cp30s -getpass admin