First, you'll need the Ondrej PPA:
apt-get install software-properties-common
add-apt-repository ppa:ondrej/php
Next, choose whether you want PHP 7.1 or 7.2:
apt-get update
apt-get install php7.2 \
php7.2-common \
php7.2-dev \
php7.2-fpm \
php7.2-mbstring \
php7.2-sodium \
php7.2-sqlite \
php7.2-xml \
php7.2-zip
(Feel free to substitute php7.2
with php7.1
and sqlite
with your preferred database driver.
Keep in mind there is no php7.1-sodium
package.)
Next, you'll need to install Caddy, Apache, nginx, or some other webserver.
Please refer to the documentation for your favorite webserver software for setting up and configuring the virtualhost for your Chronicle. Make sure you also setup LetsEncrypt for automatic HTTPS, if you're not using Caddy.
It's highly recommended that you install libsodium if you're using a version of PHP earlier than 7.2.
Once you have a working webserver configuration, you can begin to setup Chronicle.
LATESTVERSION="v1.0.4"
cd /var/www
# If our GPG key is already imported, do nothing
gpg --fingerprint 7F52D5C61D1255C731362E826B97A1C2826404DA
if [ $? -ne 0 ]; then
# Get our GPG public key
gpg --keyserver pgp.mit.edu --recv-keys 7F52D5C61D1255C731362E826B97A1C2826404DA
if [ $? -ne 0 ]; then
# Failed to download GPG public key, let's pull it from our website.
wget https://paragonie.com/static/gpg-public-key.txt
gpg --import gpg-public-key.txt
rm gpg-public-key.txt
gpg --fingerprint 7F52D5C61D1255C731362E826B97A1C2826404DA
if [ $? -ne 0 ]; then
echo "Something went wrong. The GPG public key we downloaded was not Paragon's!"
exit 1
fi
fi
fi
git clone https://github.com/paragonie/chronicle.git
cd chronicle
git tag -v $LATESTVERSION
if [ $? -ne 0 ]; then
echo "Invalid tag."
exit 1
fi
git checkout $LATESTVERSION
Next, you will need to get Composer
(if you do not already have it), and then run composer install
.
First, run php bin/install.php
to generate your server's keypair and create
a basic configuration file. Then, edit local/settings.json
to your liking.
In particular, make sure you configure your database connection settings.
Once you're ready, run php bin/make-tables.php
to populate the SQL databases.
If you're using SQLite, make sure local
(and everything in it) is owned by
www-data
.
Nothing else is specific to Ubuntu. Refer to the general setup instructions for the remaining steps.