How to Install Keitaro

OS Requirement

New empty server with CentOS 7 and higher and without any control panel. Use virtual servers (VPS and VDS) for installation.

See the full list of requirements.

Vultr — VPS in Europe, Asia, and the US. The lowest prices for VPS with SSD.

Digital Ocean — VPS with droplets in all parts of the world. Affordable VPS.

Hetzner - high-quality dedicated servers.

Installing Keitaro on Vultr

Installing Keitaro on Digital Ocean VPS

Installing Keitaro on Azure VPS from Microsoft

Installing on any Other Server

If you're using Azure or any other servers without direct root access:

yum upgrade -y && curl -sSL https://keitaro.io/install.sh | sudo bash -s -- -l en -k 9

Operational System Requirements

  • CentOS 7×64 and higher.
  • Empty server without any panels installed.

Installation Process

Note: The server must be empty when you start a script. Launch on the server with websites which were run or with control panel will entail unpredictable consequences.

Use the default Terminal app for MacOS/Linux, and Putty for Windows.

Login to your server with the command:

ssh root@x.x.x.x

where x.x.x.x change to your server's ip-address. Put in your password.

And after a successful login run a command:

yum upgrade -y && curl -sSL https://keitaro.io/install.sh | bash -s -- -l en -k 9

Follow the script's instructions:

Do you want to install a free Let's Encrypt SSL certificate?

yes - in case you install Keitaro with a domain and want to get an SSL certificate to have an https-connection;

no - in case you don't need a domain, the admin URL will be on your_IP/admin.

List your domains separated with commas (e.g. domain1.com ,domain2.com)

This question appears when you answer “Yes” for installing SSL certificates.

Do you want to use a database from SQL dump?

yes - in case you want to upload a previous database (this solution is usually used when you migrate your tracker to another server);

no - in case it's a first-time installation or you don't want to use an old database.

Insert a database name [keitaro]

Enter the database name, prompts are given after a question. Or you can insert your own name.

Database user's name [keitaro]

As in a previous point.

Database user's password [xxxxxxxxxx]

Enter Keitaro admin's name [admin]

This name is used as a login name to your tracker.

Enter Keitaro admin's password [xxxxxxxxxx]

A password to your login to a Keitaro tracker.

Server's IP-address [xxxxxxxxxx]

Enter the IP of your current server.

License key You'll get your license key after buying a license in your account on keitaro.io

After answering all the questions the installation process will be launched.

If Getting Error "curl: (35) Peer reports incompatible or unsupported protocol version."

Run this:

yum upgrade -y

Now, try to install again.

Result

Single-click installation will:

  • Install the latest versions of Nginx, MariaDB, Redis, PHP 7
  • Configure Nginx, PHP-FPM, MariaDB
  • Install Monit to monitor Nginx, MariaDB and PHP-FPM
  • Configure firewall
  • Connect a free SSL certificate from Let's Encrypt (with automatic extension)
  • Install Keitaro

Note: The script closes all ports except 22, 3333 (SSH port friendhosting), 80, 443. If your SSH is installed on a non-standard port, you will lose access to the console.

Where will the tracker be installed?

/var/www/keitaro

If the installation was cut short with an error

See the latest steps of installation. Try to identify and eliminate the cause. If you have a problem, please contact our technical support.

How to continue the installation

Run again the installation command. All parameters which were previously entered will be restored automatically.

How to Attach Domains to Keitaro (video)

Add an A-record in the domain DNS, like the following:

@   IN   A 1.2.3.4

Replace “1.2.3.4” to your server IP. After several hours, try to open the admin panel from that domain http://newdomain.com/admin.

Watch our video tutorial about adding domains on YouTube.

How to Update the Server Environment

Run:

yum update
yum upgrade

How to add SSL after installation (video)

If you chose not to install the certificate when you first start, you can install it later using the command

curl -sSL https://keitaro.io/enable-ssl.sh | bash -s -- domain1.com domain2.com

The script will not work if the server was not configured by the script of single-click installation.

Watch our video tutorial about adding SSL certificate on YouTube.

How to share install.log

You can upload the file to 'transfer.sh', just run this command:

curl -H "Max-Downloads: 1" -H "Max-Days: 5" --upload-file ./install.log https://transfer.sh/install.log

You'll get the download link. It allows just single download, after that it delete the file.

How to Add Domains/Mirrors to Keitaro

Add an A-record to the domains DNS:

@   IN    A x.x.x.x

“x.x.x.x” is your server IP.

Is it possible to enable additional IPs on a VPS and install domains on them

Yes, it is possible. You should have an active license for every IP. Then you can enable additional IPs and the tracker will work without any further configuration. Use the license key for the primary IP address during the installation.

How to open a new port on the server

Open file /etc/firewall.bash:

nano /etc/firewall.bash

Find # Open ports and add new line with your port

iptables -A INPUT -p tcp -m tcp --dport 3306 -j ACCEPT

(It opens 3306 port)

How to establish an FTP connection to a server after the installation

Use WinSCP for Windows and CyberDuck for MacOS applications. They allow to work with files via SSH as well as FTP.