Leaving Airtable? Bring your bases to Artavolo, checked record by record. See how

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.

  1. Make a folder with a docker-compose.yml for the image artavolo/artavolo-enterprise on Docker Hub. The self-hosting page says where to find one.
  2. Put a database password and your first administrator's e-mail address and password in a .env file beside it.
  3. Run docker compose up -d.
  4. 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.

  1. Request the archive on the self-hosting page, and check it against its .sha256 file.
  2. Unzip it into the folder your domain points at.
  3. Open your domain. The installer checks the server, asks for your database login, your e-mail address and a password, creates the two databases (artavolo and artavolo_data), writes the configuration and makes your account. On cPanel, create the two databases first.
  4. Delete the install folder.
  5. 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, includes and libs must 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.

Related