Requirements
Methods for the general public
Preparation
You will need :
- identifiers to access the hosting (sFTP) and the database (mySQL or MariaDb) ;
- sFTP file transfer software [1].
Method 1 : With spip_loader.php, alias «the hassle free way»
The script spip_loader.php downloads and installs the required version of SPIP. This is the simplest method to install SPIP :
- go to page Using spip_loader ;
- download the script to your computer;
- upload it using your FTP software to the desired location on your host;
Warning: set your software to make this transfer in binary mode [2].
- All you have to do is go to www.domain.tld/spip_loader.php and follow the various stages of the installation procedure.
Method 2: Upload via sFTP, aka "old school".
Once you have downloaded the zip file from the Downloading SPIP page and extracted its contents onto your computer, transfer all the files to your server using FTP software. Once the files have been transferred, follow the various steps in the installation procedure.
/plugins and /plugins/auto folders and possibly lib (for certain plugins that require it).In all cases: complete the installation
Go to the address www.domain.tld/ecrire and follow the installation procedure:
- Choose the installation language.
- Indicate the type of database and the information required.
- Choose your database or create a new one.
- Create your customised access to the site by entering your name, email address, login and password.
- Complete the installation by entering the private area
Other methods, aka "to go further"
SPIP-Cli (installation via command line)
Once SPIP-Cli has been installed on your server (read the SPIP-CLI documentation), you can use the spip command to install, update and administer SPIP.
To download the latest stable version of SPIP, run the following command from the directory you want for your site :
spip dl
Next, go to the folder containing your SPIP and prepare the folders and files (folder permissions, setting up .htaccess, etc.):
spip core:preparer
Then follow the standard installation method (see paragraph Install SPIP above).
To update, ideally you should first update SPIP-Cli, then run the command :
spip up
More infos on SPIP-Cli :
checkout script
The script checkout can be used to download or update Git (or Zip) sources and also provides a method for downloading SPIP sources.
Alternatives methods
Linux Distributions
Debian
- The Debian package installs SPIP in shared mode on a Debian or Ubuntu server.
- There is also a self-hosted Yunohost solution.
Arch Linux
A package is available on the user repository.
Vagrant
Docker
Docker_(software) automates the deployment of applications in software containers.
A number of people have come up with their own recipes for using this tool:
- On the Docker Hub
- https://github.com/rsuinux/spip3
- https://github.com/magikcypress/docker_spip
- https://github.com/ashledombos/docker-spip : ipeos fork, which is based on alpine and fpm, and integrates additional elements such as redis and all the programs needed for smush. And uses SPIP-CLI to install and manage SPIP from the command line.
Softaculous
Softaculous automatically installs applications on the command line or via control panels such as cPanel or Plesk.
The free version offers 50 applications, but SPIP is included in the paid version:
Composer
Composer is a PHP dependency management tool. It allows you to declare the libraries on which your project depends and it will manage them (install/update) for you.