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.
- Cost: about US$1 a month for most music sites (their minimum). The first 14 days are free, with no card needed to start.
- What you do: sign up with your email, copy one key from your bunny.net account and paste it into Mantis. Mantis does the rest: your site is live at yourname.b-cdn.net within a minute.
- Your own address (optional): if you have a domain, Mantis shows you the one record to add at your registrar, waits until it works and turns on HTTPS by itself.
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:
- SFTP access (or a server of your own). This is how Mantis uploads (an SSH login that can write files). Most hosting plans include it; the very cheapest "website builder" plans sometimes don't.
- Enough space. Each song is about 5–10 MB as an MP3, plus its cover. Lossless WAV downloads (optional) take around ten times more.
- Enough traffic. Every play sends the song again. Plans with a monthly allowance in the hundreds of gigabytes are plenty for most musicians.
- HTTPS. Free certificates (Let's Encrypt) are standard now; make sure yours includes them.
- Your own domain, if you want one: from the host or from any domain registrar.
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:
- Shared web hosting with SFTP: the cheapest and simplest. Your local hosting companies usually offer it.
- A small virtual server (VPS): a few dollars a month for your own little server. Our setup script sets it up for you (below).
- A server you already have: Mantis only needs a folder it can upload to.
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 (a "VPS" or "droplet"): our setup script does it all.
- Shared hosting (cPanel and similar): you add Mantis's key in your control panel.
- A server you already run: Mantis gives you the exact commands.
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.
- 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.
- Open the server's console. On DigitalOcean: the Droplet's page › Console (top right). Other hosts have a similar Console button.
- Run our setup script on the command line. Copy this, paste it into the console and press Return:
The first thing it asks for is your upload key. The script is public: read it first if you like. Its SHA-256 is
curl -fsSL --proto '=https' https://mantismusic.app/server.sh | sudo bashbef6623eb4adef767459df30191bfa11ae140b8f3d4caeb636290d8e934c3b58. - 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.
- 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).
- 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. - Back in Mantis, type the server's address and press Use this server.
- Press Test connection. Mantis asks once whether to trust the server: say yes if the fingerprint matches the one shown after Done.
- 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
- Where you bought the domain, add a record: type
A, namemusic(the part before your domain), value your server's address. - Wait until it works (minutes to an hour). Then type this in the server's console:
HTTPS turns on and keeps renewing itself.
sudo mantis-https - 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)
- 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. - In Mantis, open Site settings › Publishing and type the destination:
username@server:public_html, or with a port,username@server:2222:public_html. - 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. - 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.