Jeyser could be frightening to install. It is not ! With only basics computer science knowledge and 5 commands, you can safely deploy it on your server, https included.
If you have no server management skills, please read Environment page for some basics about it. Don't be afraid, it's easy.
Server requirements: 1vCPU, 2Go RAM, 10 Go disk space.
Connect to your server and run the Jeyser installation script
# Create a directory for jeyser mkdir -p /var/www cd /var/www # clone Jeyser code source git clone https://github.com/n7consulting/Incipio.git cd Incipio # get the latest release number on https://github.com/n7consulting/Incipio/releases git checkout v3.1.0 # run the docker installer chmod u+x install/initial-setup_ubuntu16.sh ./install/initial-setup_ubuntu16.sh
For more details, read below.
To run Jeyser you need a VPS (virtual private server) matching at least the following requirements :
- 1 vCPU
- 2 GB of RAM
- 10 Go of hard disk space
We strongly advocates for Ubuntu 20.04 (Ubuntu 18.04 is also supposed to work, Ubuntu 16.04 is likely to work as well) as your server Operating System because our automatic install scripts are only tested on Ubuntu.
Such server cost between 3 and 7 euros per month.
At N7 Consulting we use an OVH VPS SSD1 at 3€/month and it works very well.
In addition of your VPS, you will also need a subdomain pointing on your server ip. More information in the Environment setup guide.
Docker is a virtualization software that isolates applications into containers. Don't panic if you don't understand that definition. As for Jeyser, we use Docker to ship a standard environment.
Using the docker install has many benefits : Automatic install, automatic and free SSL certificate (https), already configured server and software. It is the best for non tech people.
In the following steps, we assume that your server will be used to run only Jeyser. If it is not the case, please refer to the FAQ
We can't make installation easier than that. Feel free to ask for help if you need some.
Once a subdomain is pointing on your server ip and you connected to your server:
- copy paste the lines of the Jeyser installation script (see above) in your console
- Answer the subdomain and contact email question
- In case of questions during installation (such as figure below) choose the first or second option and validate with "Enter"
That's all ! Jeyser is now installing itself. Don't be afraid, it can take some time.
At the end of the installation process, if go to the configured subdomain (first connection can take several seconds)
you should have a working login page.
Connect with the credentials
admin/admin and don't forget to change them right after your first login.