Install Artavolo on your own server
Updated
You can run Artavolo on your own server with Docker, or with PHP and MySQL on ordinary hosting. Both are the same application. Without a licence key it runs as the free Community edition, with no limit on people, records or bases, and it never calls home.
Install with Docker
You need Docker 24 or newer, on Linux, macOS or Windows.
- Make a folder with a
docker-compose.ymlfor the imageartavolo/artavolo-enterpriseon Docker Hub. The self-hosting page says where to find one. - Put a database password and your first administrator's e-mail address and password in a
.envfile beside it. - Run
docker compose up -d. - Open the address and sign in with that administrator's e-mail address and password.
The stack runs the application, the database, the cache and HTTPS. With a domain name set in .env, the certificate is obtained and renewed for you.
Install with PHP and MySQL
You need PHP 8.1 or newer with the imagick, curl, fileinfo, gd, mbstring, iconv, intl and zip extensions, MySQL or MariaDB, and Apache with mod_rewrite and AllowOverride All.
- Request the archive on the self-hosting page, and check it against its
.sha256file. - Unzip it into the folder your domain points at.
- Open your domain. The installer checks the server, asks for your database login, your e-mail address and a password, creates the two databases (
artavoloandartavolo_data), writes the configuration and makes your account. On cPanel, create the two databases first. - Delete the
installfolder. - Add the cron job, every 5 minutes as the web server user:
*/5 * * * * cd /path/to/artavolo/site && php cron.php. It runs scheduled automations, reminders, audit log retention and scheduled backups.
After it is running
- Set up outgoing e-mail: in the administration, Settings, General, E-mail settings, tick Use SMTP and enter your mail provider's details. A Docker container has no mail transport of its own, so invitations and password resets are not delivered until you do.
- Set
BACKUP_ENCRYPTION_KEY(in Docker,ARTAVOLO_BACKUP_ENCRYPTION_KEY) to 32 or more random characters, and keep a copy somewhere else. See Schedule encrypted backups. - If you have a licence key, paste it in. See Apply a licence key.
Upgrade
With Docker, set the new image version, then run docker compose pull and docker compose up -d; database changes run when the container starts. With PHP, run php utilities/upgrade.php with the new archive: it checks the archive, keeps a copy of the current code, keeps your configuration, uploads and data, and runs the database changes.
Good to know
- The plans cost the same on your server as in our cloud, priced per person, with a licence key for the people you name. The Community edition is enough for many teams. See Plans, prices and how you pay.
- Live updates (other people's changes appearing without a reload) need the separate websocket server; the installation guide says how to start it.
- The folders
data,includesandlibsmust not be readable from the web. They ship with rules that deny it; if your Apache ignores.htaccess, copy them into the site's configuration.