# Install Artavolo on your own server

> Run Artavolo yourself with Docker or with PHP and MySQL. The free Community edition has no limit on people, records or bases.

Source: https://artavolo.com/page/install-artavolo

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](https://artavolo.com/downloads) 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](https://artavolo.com/downloads), 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](https://artavolo.com/page/scheduled-backups).
- If you have a licence key, paste it in. See [Apply a licence key](https://artavolo.com/page/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](https://artavolo.com/page/billing).
- Live updates (other people's changes appearing without a reload) need the separate websocket server; the [installation guide](https://artavolo.com/docs/lamp-install) 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

- [Apply a licence key](https://artavolo.com/page/apply-a-licence-key)
- [Schedule encrypted backups](https://artavolo.com/page/scheduled-backups)
- [Set up single sign-on](https://artavolo.com/page/single-sign-on)
- [Installing on a LAMP server](https://artavolo.com/docs/lamp-install)
