Hosting with Uberspace

Uberspace is a perfect fit if you prefer to have SFTP-access to your type foundry platform. It’s a bit more technical, but this guide will cover the basics.

Create an account at Uberspace. After you’ve created you account and logged in, you need to create an Asteroid, and this is free for the first month. Select Uberspace 8, with default Asteroid setup.

Setup SSH

The more technical part is to setup SSH. You need this, because in a later step you’re going to install FontTools on your Asteroid. This guide SSH - Uberspace 8 Manual will guide you through the steps.

Install FontTools

Open your terminal and write ssh [asteroid_name]@[server].uberspace.de. Replace asteroid_name and server with what’s correct for you. If SSH is setup, you should get a Welcome to Uberspace 8! in the terminal.

To install FontTools, all you need to type is python3 -m pip install --user fonttools and wait for it to finish. Uberspace comes with Python 3 installed.

Upload you site

In your Asteroid home folder is where you need to keep everything you need to keep secure. The default setup in Fountain is perfect for this.

In the www/html-folder you put things that needs to be public. And this is crucial. Everything in this folder is accessible to people using the same server. The rest of the guide will referred to this as the public folder.

Using default CSS or JS from Fountain?

If you plan to use any of the default CSS or JS that comes with Fountain, you need to upload these to the public folder, and change the snippets referring to them. Kirby::plugin( 'nymarktype/fountain' )->asset( 'scripts/app.bundle.js' )->url() can be replaced with '/assets/scripts/app.bundle.js' or whatever setup you prefer.

Setup `index.php`

The file index.php and .htaccess both need to be in the public folder, along with the assets folder. The changes you need to make, where you replace [asteroid_name] with the name of your Uberspace Asteroid:

Line 9:

$base = '/home/[asteroid_name]';

Line 21:

'media' => '/var/www/virtual/[asteroid_name]/html/media',

Don’t put any other folders in the public folder.

With the Fountain starterkit, the folders you should add in the home folder are data, kirby and site. And vendor if you’ve used Composer to install plugins/Kirby.