Mantis Music

A home for your site

Your Mantis site is made solely of static files: pages, songs, covers and a little data. To be on the web it needs a web host: a company that keeps those files and sends them to anyone who visits. Mantis puts your music there every time you publish.

You choose the host and you pay them directly, so your site stays yours. Mantis doesn't sell hosting, and we don't guarantee any host: these are suggestions to get you started.

The easiest option: bunny.net

Mantis can set everything up on bunny.net for you. It's a fast European host that sends your site from servers all over the world.

About our link: if you sign up through our bunny.net link, bunny.net pays Mantis Music a small referrer fee. It costs you nothing extra, and it helps us keep Mantis free. We picked bunny.net simply because it was the easiest host we tried. Any web host works with Mantis: see below.

In Mantis: Set up publishing… › Give me the easiest option (on the Mac in Site settings or Home; on iPhone and iPad in Publish).

Any other host: what to look for

Almost any web host can serve a Mantis site, because it's just simple files. Check for these:

You don't need PHP, databases, WordPress or anything that runs on the server. That makes your site very hard to break into, even as AI makes hacking easier, and your hosting very cheap: often cheaper each year than what a distributor charges to keep your music on the big platforms.

Good kinds of hosting:

Your own web host, step by step

Simple and safe. We've tried to make every step easy and secure. Your passwords never go into Mantis: it uses its own key, kept in your iCloud Keychain, only to upload your site. On a server of your own, our setup also limits that key to your site's folder, and turns on a firewall, automatic security updates and HTTPS. The setup script is short and public, so anyone can check it.

In Mantis, choose Set up publishing… › Walk me through my own web host: it takes you through every step below, with buttons to copy and test. Pick whichever matches your hosting:

A server of your own

Small servers cost a few dollars a month at DigitalOcean, Vultr, Hetzner, Linode and many others. Our setup script turns a brand-new one into a home for your site in a few minutes.

  1. Make the server at your host. Choose Ubuntu (the newest LTS version) and the smallest size. When it asks how you'll log in, choose Password and make a strong one.
  2. Open the server's console. On DigitalOcean: the Droplet's page › Console (top right). Other hosts have a similar Console button.
  3. Run our setup script on the command line. Copy this, paste it into the console and press Return:
    curl -fsSL --proto '=https' https://mantismusic.app/server.sh | sudo bash
    The first thing it asks for is your upload key. The script is public: read it first if you like. Its SHA-256 is bef6623eb4adef767459df30191bfa11ae140b8f3d4caeb636290d8e934c3b58.
  4. Get your upload key from Mantis. Open Site settings › Publishing › Set up the server… › A new server and press Copy upload key. Paste it into the console and press Return.
  5. Your site's own address. Next it asks for your address, like music.yourname.com. Type it if you have one, or just press Return (you can add it later).
  6. Wait for Done. It takes two to five minutes. At the end it shows your server's address (like 203.0.113.7) and its fingerprint.
  7. Back in Mantis, type the server's address and press Use this server.
  8. Press Test connection. Mantis asks once whether to trust the server: say yes if the fingerprint matches the one shown after Done.
  9. Press Publish to test folder and open http://your-server's-address/mantis-test/ in your browser. When it looks right, press Publish. Your site is live.

Adding your own address later

  1. Where you bought the domain, add a record: type A, name music (the part before your domain), value your server's address.
  2. Wait until it works (minutes to an hour). Then type this in the server's console:
    sudo mantis-https
    HTTPS turns on and keeps renewing itself.
  3. In Mantis, set Site URL to https://music.yourname.com/ and publish.

What the setup script does, all on your server (you can read the script): installs the nginx web server with the settings Mantis sites need; makes an account, mantis-upload, that can only upload by SFTP into your site's folder and logs in only with your site's upload key; lets in only ssh and the web; turns on automatic security updates; and sets up free HTTPS certificates from Let's Encrypt. It's safe to run again.

Shared hosting (cPanel and similar)

  1. Find your SFTP details in your host's welcome email or control panel: the server's name, your user name, the port (usually 22; some hosts use another, like 2222) and your website's folder (usually public_html). In cPanel they're in the General information panel. Some hosts need SSH access switched on first: it's often a switch in the panel, or ask their support.
  2. In Mantis, open Site settings › Publishing and type the destination: username@server:public_html, or with a port, username@server:2222:public_html.
  3. Add Mantis's upload key: press Copy beside Upload key. In cPanel: Security › SSH Access › Manage SSH Keys › Import Key, name it mantis, paste into Public key and press Import; back in the list, press Manage › Authorize. Other panels have a similar SSH keys page.
  4. Press Test connection (say yes to trust the server), then Publish to test folder and look at your-site/mantis-test/. When it looks right, Publish.

Everything a listener sees works on shared hosting. A few fediverse extras (other servers finding you by name) need settings only a server of your own has.

A server you already run

Type the destination as user@server:/path/to/your/site, then Set up the server… › A server I already run. Mantis shows the exact commands: an upload-only account limited to your site's folder, let in with your site's upload key. Run them with sudo (or give them to whoever runs the server), then Test connection.

Domains, briefly

A domain (like yourname.com) comes from a registrar, for a small yearly fee. To point it at your site you add a record in its DNS settings. A subdomain such as music.yourname.com is the easiest to point at any host: one CNAME record. A bare domain (yourname.com on its own) needs your host's own instructions.